Criar um plano
Aplica-se a: Pacote do Windows Azure
Cria um novo plano.
Solicitação
Especifique a solicitação Criar Plano da seguinte maneira: Substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços:
Método |
URI da solicitação |
Versão HTTP |
|---|---|---|
POST |
<https:// ServiceMgmt>:30004/plans |
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 de sessão do cliente. |
x-ms-principal-liveid |
Opcional. O principal identificador ao vivo. |
Corpo da solicitação
A tabela a seguir descreve os elementos do corpo da solicitação.
Nome do elemento |
Descrição |
|---|---|
Plano |
Para obter mais informações, consulte Plan (objeto Administrator). |
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 status código 201 (CREATED). 409 (CONFLICT) será retornado se o nome do plano solicitado já existir.
Para obter informações sobre status códigos, consulte Status e Códigos de Erro (Gerenciamento de Serviços do Windows 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 do protocolo HTTP/1.1.
Corpo da resposta
A tabela a seguir descreve os principais elementos do corpo da resposta:
Nome do elemento |
Descrição |
|---|---|
Plano |
O novo plano. Para obter mais informações, consulte Atualizar um plano. |
Exemplo
O exemplo a seguir mostra uma solicitação Criar Plano .
POST https://<Computer>:30004/plans HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: e995f8b2-9a85-446e-a680-c424347c2a07-2013-06-28 17:58:52Z
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: 1132
Expect: 100-continue
{
"Id": "GoldPhihoq8oa",
"DisplayName": "Gold_Plan-1",
"State": 0,
"ConfigState": 0,
"QuotaSyncState": 2,
"LastErrorMessage": null,
"Advertisements": [
{
"LanguageCode": "en-us",
"DisplayName": "Gold_Plan-1",
"Description": null
}
],
"ServiceQuotas": [
{
"ServiceName": "webspaces",
"ServiceInstanceId": "0EA2F3E5-90D1-4CF0-B53D-5A111FF43122",
"ServiceDisplayName": "Web Site Cloud",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
},
{
"ServiceName": "sqlservers",
"ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
"ServiceDisplayName": "SQL Servers",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
},
{
"ServiceName": "servicebus",
"ServiceInstanceId": "51680204-CF5D-43DD-B264-4D5CB6076E02",
"ServiceDisplayName": "Service Bus",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
}
],
"SubscriptionCount": 0,
"MaxSubscriptionsPerAccount": 1,
"AddOnReferences": [
{
"AddOnId": "SqlAOwlcnkya2zmcn1xhz",
"AddOnInstanceId": null,
"AcquisitionTime": null
},
{
"AddOnId": "SqlAOtqjctbuhtvmjmkyg",
"AddOnInstanceId": null,
"AcquisitionTime": null
}
],
"AddOns": [
],
"InvitationCode": null,
"Price": null
}
O exemplo de código a seguir mostra uma resposta Criar Plano .
{
"Id": "GoldPhihoq8oa",
"DisplayName": "Gold_Plan-1",
"State": 0,
"ConfigState": 1,
"QuotaSyncState": 0,
"LastErrorMessage": null,
"Advertisements": [
{
"LanguageCode": "en-us",
"DisplayName": "Gold_Plan-1",
"Description": null
}
],
"ServiceQuotas": [
{
"ServiceName": "webspaces",
"ServiceInstanceId": "0EA2F3E5-90D1-4CF0-B53D-5A111FF43122",
"ServiceDisplayName": "Web Site Cloud",
"ServiceInstanceDisplayName": "autotest1",
"ConfigState": 1,
"QuotaSyncState": 0,
"Settings": [
{
"Key": "BytesReceived_Shared_WebSpace_Limited",
"Value": "{\"ComputeMode\":0,\"CustomActionName\":null,\"EnforcementScope\":0,\"ExceededAction\":0,\"Limit\":-1,\"Period\":1440,\"QuotaName\":\"BytesReceived\",\"ResourceName\":\"BytesReceived\",\"SiteMode\":\"Limited\",\"Unit\":1,\"WebPlan\":null}"
}
]
},
{
"ServiceName": "sqlservers",
"ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
"ServiceDisplayName": "SQL Servers",
"ServiceInstanceDisplayName": "SQL Servers",
"ConfigState": 1,
"QuotaSyncState": 0,
"Settings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"062813055853\",\"groupType\":null}]"
}
]
},
{
"ServiceName": "servicebus",
"ServiceInstanceId": "51680204-CF5D-43DD-B264-4D5CB6076E02",
"ServiceDisplayName": "Service Bus Cloud",
"ServiceInstanceDisplayName": "MyServiceBusFarm",
"ConfigState": 1,
"QuotaSyncState": 0,
"Settings": [
]
}
],
"SubscriptionCount": 0,
"MaxSubscriptionsPerAccount": 1,
"AddOnReferences": [
{
"AddOnId": "SqlAOwlcnkya2zmcn1xhz",
"AddOnInstanceId": null,
"AcquisitionTime": null
},
{
"AddOnId": "SqlAOtqjctbuhtvmjmkyg",
"AddOnInstanceId": null,
"AcquisitionTime": null
}
],
"AddOns": [
{
"Id": "SqlAOwlcnkya2zmcn1xhz",
"DisplayName": "SqlAOwlcnkya2",
"State": 0,
"ConfigState": 1,
"QuotaSyncState": 0,
"LastErrorMessage": null,
"Advertisements": [
{
"LanguageCode": "en-us",
"DisplayName": "SqlAOwlcnkya2",
"Description": null
}
],
"ServiceQuotas": [
{
"ServiceName": "sqlservers",
"ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
"ServiceDisplayName": "SQL Servers",
"ServiceInstanceDisplayName": "SQL Servers",
"ConfigState": 1,
"QuotaSyncState": 0,
"Settings": [
{
"Key": "Editions",
"Value": "[{\"groupName\":\"Default\",\"resourceCount\":\"2\",\"resourceSize\":\"10\",\"offerEditionId\":\"1367541399669\"}]"
}
]
}
],
"SubscriptionCount": 1,
"AssociatedPlans": [
],
"MaxOccurrencesPerPlan": 1,
"Price": null
},
{
"Id": "SqlAOtqjctbuhtvmjmkyg",
"DisplayName": "SqlAOtqjctbuh",
"State": 0,
"ConfigState": 1,
"QuotaSyncState": 0,
"LastErrorMessage": null,
"Advertisements": [
{
"LanguageCode": "en-us",
"DisplayName": "SqlAOtqjctbuh",
"Description": null
}
],
"ServiceQuotas": [
{
"ServiceName": "sqlservers",
"ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
"ServiceDisplayName": "SQL Servers",
"ServiceInstanceDisplayName": "SQL Servers",
"ConfigState": 1,
"QuotaSyncState": 0,
"Settings": [
{
"Key": "Editions",
"Value": "[{\"groupName\":\"Default\",\"resourceCount\":\"2\",\"resourceSize\":\"10\",\"offerEditionId\":\"1367541399669\"}]"
}
]
}
],
"SubscriptionCount": 1,
"AssociatedPlans": [
],
"MaxOccurrencesPerPlan": 1,
"Price": null
}
],
"InvitationCode": null,
"Price": null
}
Comentários
No Pacote do Windows Azure, os planos devem ter um objeto DisplayName exclusivo do objeto Plan (objeto Administrador) e o valor da ID do objeto Plan. Para obter uma lista da chamada de planos atuais , recupere os planos disponíveis. Use essas informações para garantir valores exclusivos de DisplayName e Id ao criar um novo plano.
Os caracteres permitidos para Id são ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~:/?#[]@!$&'()*+;=