O artigo solicitado não está disponível. Ou ele não se aplica a esta versão do produto ou as informações relevantes estão organizadas de forma diferente nesta versão dos documentos. Você pode pesquisar, navegar ou voltar para a outra versão.

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 um novo token para um usuário

05/23/2026

PDFs

POST /accounts/{account_id}/core/v1/users/{user_id}/tokens

Indica os valores desejados para o recurso da API de Token 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}}
ID do usuário	string	caminho	Verdadeiro	ID do recurso de usuário que o contém

Nome

Tipo

Obrigatório

Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

exemplo: {{.Account}}

ID do usuário

string

caminho

Verdadeiro

ID do recurso de usuário que o contém

Corpo da solicitação

Indica os valores desejados para o recurso da API de Token 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-token"
versão	string	Verdadeiro	Versão do recurso. Os valores definidos são: "1,0"
nome	string	Verdadeiro	String JSON contendo o nome de um token. Os valores definidos são: Comprimento mínimo: 1 Comprimento máximo: 63 Essa string é validada internamente para evitar ataques de XSS, Unicode, travessia de diretório e injeção de SQL.
metadados	"type_astra_metadados_update"	Falso	Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são: Está em conformidade com 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

tipo

string

Verdadeiro

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

"application/astra-token"

versão

string

Verdadeiro

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

"1,0"

nome

string

Verdadeiro

String JSON contendo o nome de um token. Os valores definidos são:

Comprimento mínimo: 1
Comprimento máximo: 63
Essa string é validada internamente para evitar ataques de XSS, Unicode, travessia de diretório e injeção de SQL.

metadados

"type_astra_metadados_update"

Falso

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

Está em conformidade com 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-token",
  "version": "1.0",
  "name": "Snapshot Script"
}

Resposta

Status: 201, Returns the newly created token 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-token"
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
nome	string	Verdadeiro	String JSON contendo o nome de um token. Os valores definidos são: Comprimento mínimo: 1 Comprimento máximo: 63 Essa string é validada internamente para evitar ataques de XSS, Unicode, travessia de diretório e injeção de SQL.
ID do usuário	string	Verdadeiro	String JSON contendo o UUID do usuário associado ao token. Os valores definidos são: Conforme o esquema de identificador Astra
token	string	Verdadeiro	String JSON contendo um token de API gerado pelo sistema e codificado em base64. Os valores definidos são: Está em conformidade com o esquema de dados codificados em base64
metadados	"type_astra_metadados_update"	Verdadeiro	Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são: Está em conformidade com 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

tipo

string

Verdadeiro

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

"application/astra-token"

versão

string

Verdadeiro

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

"1,0"

string

Verdadeiro

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

Em conformidade com o esquema UUIDv4

nome

string

Verdadeiro

String JSON contendo o nome de um token. Os valores definidos são:

Comprimento mínimo: 1
Comprimento máximo: 63
Essa string é validada internamente para evitar ataques de XSS, Unicode, travessia de diretório e injeção de SQL.

ID do usuário

string

Verdadeiro

String JSON contendo o UUID do usuário associado ao token. Os valores definidos são:

Conforme o esquema de identificador Astra

token

string

Verdadeiro

String JSON contendo um token de API gerado pelo sistema e codificado em base64. Os valores definidos são:

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

metadados

"type_astra_metadados_update"

Verdadeiro

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

Está em conformidade com 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-token",
  "version": "1.0",
  "id": "822fab12-c224-5d1f-8118-5fb5d2def8b9",
  "name": "Snapshot Script",
  "userID": "09f8933c-ad74-4f4e-8ef5-1ffaa0fb8e9b",
  "token": "QSBKV1QgVG9rZW4gd291bGQgZ28gaGVyZS4=",
  "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
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

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

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

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
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

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
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

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

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:

Está em conformidade com 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
etiquetas	array["tipo_astra_label"]	Falso
CriaçãoTimestamp	string	Falso
Alteração do Timestamp	string	Falso
CreatedBy	string	Falso
modifiedBy	string	Falso

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

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

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

Criar um novo token para um usuário

Creating your file...

Parâmetros

Corpo da solicitação

Resposta

Resposta

Resposta

Resposta

Resposta

Erro

Definições