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 licença

PDFs

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

Indica os valores desejados para o recurso da API License 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 License 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-license"

versão

string

Verdadeiro

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

  • "1,0"

alocação

string

Falso

String JSON contendo um ID que indica a que a licença está alocada. Presente somente quando a licença está alocada. Para licenças do Astra Control Center, este campo deve ser preenchido com o ID da conta e deve corresponder ao ID da conta especificado no URI POST. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID de credenciais do dispositivo

string

Falso

String JSON contendo o identificador do deviceCredential associado à API de Credenciais. Presente apenas para licenças do Astra Data Store. Os valores definidos são:

  • Conforme o esquema de identificador Astra

licenseText

string

Verdadeiro

String JSON contendo uma representação codificada em base64 do JSON da licença, conforme obtido do sistema de licenciamento NetApp. Esta string deve ser fornecida na ordem original de bytes para permitir a verificação da assinatura. Os valores definidos são:

  • Está em conformidade com o esquema de dados codificados em base64

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-license",
  "version": "1.0",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9"
}

Resposta

Status: 201, Returns the newly created license 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-license"

versão

string

Verdadeiro

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

  • "1,0"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

alocação

string

Falso

String JSON contendo um ID que indica a que a licença está alocada. Presente somente quando a licença está alocada. Para licenças do Astra Control Center, este campo deve ser preenchido com o ID da conta e deve corresponder ao ID da conta especificado no URI POST. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID do host

string

Falso

String JSON contendo um identificador de host ao qual uma licença está vinculada. Presente apenas se a licença estiver vinculada a um host específico. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

ID de credenciais do dispositivo

string

Falso

String JSON contendo o identificador do deviceCredential associado à API de Credenciais. Presente apenas para licenças do Astra Data Store. Os valores definidos são:

  • Conforme o esquema de identificador Astra

isEvaluation

string

Verdadeiro

String JSON que indica se a licença é uma licença de avaliação. Os valores definidos são:

  • "true"

  • "false"

licenseProtocol

string

Verdadeiro

String JSON contendo o protocolo de licença extraído da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

licenseText

string

Verdadeiro

String JSON contendo uma representação codificada em base64 do JSON da licença, conforme obtido do sistema de licenciamento NetApp. Esta string deve ser fornecida na ordem original de bytes para permitir a verificação da assinatura. Os valores definidos são:

  • Está em conformidade com o esquema de dados codificados em base64

validFromTimestamp

string

Verdadeiro

String JSON contendo um registro de data e hora indicando quando a licença se torna válida. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

validUntilTimestamp

string

Verdadeiro

String JSON contendo um registro de data e hora indicando quando a licença deixa de ser válida. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

produto

string

Verdadeiro

String JSON contendo a string do produto extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

productVersion

string

Verdadeiro

String JSON contendo a string de versão extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

produtoSN

string

Verdadeiro

String JSON contendo a string do número de série extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

características

string

Verdadeiro

String JSON contendo o valor do pacote extraído da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

capacidade

string

Verdadeiro

String JSON contendo a capacidade extraída da licença.

capacity2

string

Verdadeiro

String JSON contendo a capacidade secundária extraída da licença.

complementos

variedade["complementos"]

Falso

Matriz JSON de objetos JSON contendo a lista de complementos da licença. Um complemento é uma alteração na licença que pode ocorrer em uma data futura.

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-license",
  "version": "1.0",
  "id": "6db53b32-8417-5d3c-8ef0-552fc602c78f",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "hostID": "99132549-e0c2-4203-9d1e-598628b4ff9b",
  "isEvaluation": "false",
  "licenseProtocol": "ASTRASDS-ENT-SUBS",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9",
  "validFromTimestamp": "2020-08-06T00:00:00.000000Z",
  "validUntilTimestamp": "2021-08-06T00:00:00.000000Z",
  "product": "Astra Control Center",
  "productVersion": "1.0",
  "productSN": "320000046",
  "features": "ASTRA-ENT-STD",
  "capacity": "4000",
  "capacity2": "0",
  "addons": [
    {
      "startDate": "2020-08-06T00:00:00.000000Z",
      "endDate": "2021-08-06T00:00:00.000000Z",
      "capacity": "4000",
      "licenseProtocol": "ASTRA-ENT-STD",
      "features": "p-nfs,dm-storage-policy-based-pvs-for-k8s,dm-spbm-based-vvols-for-vms,dm-storage-efficiency,dm-data-at-rest-encryption"
    }
  ],
  "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
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

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

complementos

Nome Tipo Obrigatório Descrição

startDate

string

Falso

String JSON contendo um carimbo de data/hora indicando quando este complemento se torna válido. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

endDate

string

Falso

String JSON contendo um carimbo de data/hora indicando quando este complemento deixa de ser válido. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

características

string

Falso

String JSON contendo a lista de funcionalidades associadas a este complemento. Os valores definidos são:

  • O conteúdo da string não foi validado pelo esquema.

capacidade

string

Falso

String JSON contendo a capacidade extraída do complemento. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

licenseProtocol

string

Falso

String JSON contendo o protocolo de licença associado a este complemento. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

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