Skip to main content
Astra Automation
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Criar uma nova assinatura

PDFs

POST /accounts/{account_id}/core/v1/subscriptions

Indica os valores desejados para o recurso da API de Subscription a ser criado.

Parâmetros

Nome Tipo Em Obrigatório Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

  • exemplo: {{.Account}}

Corpo da solicitação

Indica os valores desejados para o recurso da API de Subscription a ser criado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-subscription"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

  • "1,1"

  • "1,2"

ID do perfil do cliente

string

Falso

String JSON contendo o ID do perfil do cliente de "Authorize.net", que foi invocada pela interface do usuário, não está definida para o período de carência. Retorna uma string vazia durante a operação de leitura, caso não esteja definida. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

paymentFirstName

string

Falso

String JSON contendo um nome completo especificado pelo usuário, usado para faturamento de pagamentos. Especificado apenas quando a assinatura está sendo renovada. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

paymentLastName

string

Falso

String JSON contendo o sobrenome completo especificado pelo usuário, utilizado para faturamento da assinatura. Especificado apenas quando a assinatura está sendo renovada. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

paymentAddress

"paymentAddress"

Falso

Objeto JSON contendo uma coleção de strings JSON que especificam um endereço de cobrança. Especificado apenas quando a assinatura está sendo renovada. Se esta chave existir, todas as seis strings JSON contidas estarão presentes. Se nada for fornecido pelo usuário, a string estará vazia.

ID do perfil de pagamento

string

Falso

String JSON contendo o ID do perfil de pagamento "Authorize.net" que foi invocado pela interface do usuário, não definido para o período de avaliação. Retorna uma string vazia durante a operação de leitura se não estiver definido. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

paymentExpiry

string

Falso

String JSON contendo um timestamp indicando quando o método de pagamento expira. Este valor é obtido do authorize.net(http://authorize.net e definido pela interface do usuário. Os valores definidos são:

  • Em conformidade com o padrão de data e hora ISO-8601 Este campo não é retornado durante o período de avaliação.

marketplace

string

Falso

String JSON que indica o marketplace para uma conta onde os pagamentos serão registrados. Valores definidos:

  • "netapp"

  • "azure"

  • "aws"

  • "gcp"

termos

string

Verdadeiro

String JSON que indica o nível atual da conta. Os valores definidos são:

  • "teste"

  • "pago"

metadados

"type_astra_metadados_update"

Falso

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.
Exemplo de solicitação 
{
  "type": "application/astra-subscription",
  "version": "1.2",
  "terms": "trial"
}

Resposta

Status: 201, Returns the newly created subscription resource in the JSON response body.
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-subscription"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

  • "1,1"

  • "1,2"

id

string

Verdadeiro

Identificador globalmente único do recurso. Os valores definidos são:

  • Em conformidade com o esquema UUIDv4

ID do perfil do cliente

string

Verdadeiro

String JSON contendo o ID do perfil do cliente de "Authorize.net", que foi invocada pela interface do usuário, não está definida para o período de carência. Retorna uma string vazia durante a operação de leitura, caso não esteja definida. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

ID do perfil de pagamento

string

Falso

String JSON contendo o ID do perfil de pagamento "Authorize.net" que foi invocado pela interface do usuário, não definido para o período de avaliação. Retorna uma string vazia durante a operação de leitura se não estiver definido. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

paymentExpiry

string

Falso

String JSON contendo um timestamp indicando quando o método de pagamento expira. Este valor é obtido do authorize.net(http://authorize.net e definido pela interface do usuário. Os valores definidos são:

  • Em conformidade com o padrão de data e hora ISO-8601 Este campo não é retornado durante o período de avaliação.

purchaseOrderNumber

string

Falso

String JSON contendo o número do pedido de compra para o método de pagamento. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 31

marketplace

string

Falso

String JSON que indica o marketplace para uma conta onde os pagamentos serão registrados. Valores definidos:

  • "netapp"

  • "azure"

  • "aws"

  • "gcp"

licenseSN

string

Falso

String JSON contendo o número de série da licença para o método de pagamento. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 31

termos

string

Verdadeiro

String JSON que indica o nível atual da conta. Os valores definidos são:

  • "teste"

  • "pago"

status

string

Verdadeiro

String JSON que indica o status atual da assinatura. Os valores definidos são:

  • "ativo"

  • "inativo"

appLimit

número

Verdadeiro

Número JSON que indica o limite de aplicativos para esta assinatura. O valor -1 indica que não há limite.

namespaceLimit

número

Verdadeiro

Número JSON que indica o limite de namespace para esta assinatura. Valor -1 indica que não há limite.

subscriptionPeriod

número

Verdadeiro

Número JSON que indica o período de assinatura. O valor -1 indica que não há limite. Unidade: dias

gracePeriod

número

Verdadeiro

Número JSON que indica o período de carência após o término da assinatura de avaliação ou o cancelamento de uma assinatura paga. Unidade: dias

reminderBeforePeriod

número

Verdadeiro

Número JSON que indica a quantidade de dias antes do término da assinatura de avaliação, quando as notificações ao cliente serão iniciadas. O valor é expresso em dias, sendo -1 indicativo de que não se aplica.

onboardStatus

string

Verdadeiro

String JSON que indica o status atual do processo de integração do cliente. Os valores válidos são "não iniciado", "em andamento", "sucesso", "falha". Os valores definidos são:

  • "não iniciado"

  • "em andamento"

  • "sucesso"

  • "falhou"

costPerAppUnit

número

Verdadeiro

Número JSON que indica o custo por unidade do aplicativo. Para uma versão de avaliação, o valor é 0. Unidade: dólares americanos

costPerNamespaceUnit

número

Verdadeiro

Número JSON que indica o custo por unidade de namespace. Para uma versão de avaliação, o valor é 0. Unidade: dólares americanos

metadados

"type_astra_metadados_update"

Verdadeiro

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.
Exemplo de resposta 
{
  "type": "application/astra-subscription",
  "version": "1.2",
  "id": "40b4106f-b743-5d83-95c7-d539b2b45f63",
  "customerProfileID": "2157047189",
  "paymentProfileID": "E7CEB0A9F1BECA32A02493E1B31D5955",
  "paymentExpiry": "2022-02-01T00:00:00Z",
  "purchaseOrderNumber": "72384632",
  "marketplace": "netapp",
  "licenseSN": "278343",
  "terms": "trial",
  "status": "active",
  "appLimit": 0,
  "namespaceLimit": 10,
  "subscriptionPeriod": 90,
  "gracePeriod": 7,
  "reminderBeforePeriod": 30,
  "onboardStatus": "in progress",
  "costPerAppUnit": 0,
  "costPerNamespaceUnit": 0.005,
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Resposta

Status: 401, Unauthorized
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Resposta

Status: 400, Bad request
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Resposta

Status: 409, Conflict
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Resposta

Status: 403, Forbidden
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Erro

Status: 404, Not found
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta de erro 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

paymentAddress

Objeto JSON contendo uma coleção de strings JSON que especificam um endereço de cobrança. Especificado apenas quando a assinatura está sendo renovada. Se esta chave existir, todas as seis strings JSON contidas estarão presentes. Se nada for fornecido pelo usuário, a string estará vazia.

Nome Tipo Obrigatório Descrição

addressCountry

string

Verdadeiro

Cadeia JSON contendo o nome ou código do país associado ao endereço postal, conforme especificado na norma ISO 3166 Alpha-2. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 2

addressLocality

string

Verdadeiro

String JSON contendo a localidade (por exemplo, cidade) associada ao endereço postal. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

addressRegion

string

Verdadeiro

String JSON contendo a região (por exemplo, estado) associada ao endereço postal. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

postalCode

string

Verdadeiro

String JSON contendo o código postal associado ao endereço postal. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

streetAddress1

string

Verdadeiro

String JSON contendo o endereço da rua associado ao endereço postal. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

streetAddress2

string

Falso

String JSON contendo informações opcionais de endereço de rua, caixa postal e outros dados adicionais. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

type_astra_metadados_update

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

invalidParams

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do parâmetro de consulta inválido

razão

string

Verdadeiro

Motivo pelo qual o parâmetro de consulta é inválido

invalidFields

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do campo inválido no corpo da requisição

razão

string

Verdadeiro

Motivo pelo qual o campo do corpo da solicitação é inválido