Docs Menu
Docs Home
/ /
agentes

Crear una clave API de agente

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

POST /groups/{PROJECT-ID}/agentapikeys

Este punto final está restringido a usuarios con Project Owner role.

Nombre
Tipo
Descripción

PROJECT-ID

string

Identificador único del proyecto que posee la clave API del agente.

Los siguientes parámetros de consulta son opcionales:

Nombre
Tipo
Necesidad
Descripción
predeterminado

bonita

booleano

Opcional

false

envolvente

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre
Descripción

Estado

Código de respuestaHTTP

envolvente

Cuerpo de respuesta esperado

false

Nombre
Tipo
Descripción

desc

string

Etiqueta para esta clave API de agente.

Nombre
Tipo
Descripción

ID.

string

Identificador único de esta clave API de agente.

clave

string

Clave API del agente.

Después de crear esta clave API del agente, las solicitudes posteriores devuelven los últimos cuatro caracteres de las claves API del agente.

desc

string

Etiqueta para esta clave API del agente. Limitada a 1,000 caracteres.

tiempo de creación

string

Marca de tiempo en formato ISO 8601 de fecha y hora en UTC cuando se creó la clave API del agente.

ID de usuario creado

string

Identificador único del usuario que creó esta clave API de agente.

direcciónIP creada

string

DirecciónIP que creó esta clave API del agente.

creado por

string

Origen de esta clave API del agente. Los valores aceptados son:

  • USER

  • OLD_KEY

  • PROVISIONING

  • ATLAS

  • PUBLIC_API

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--include \
--request POST "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/agentapikeys?pretty=true" \
--data '
{
"desc": "Agent API Key for this project"
}'
HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive
HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{
"_id" : "{AGENT-API-KEY-ID}",
"createdBy" : "PUBLIC_API",
"createdIpAddr" : "{IP-ADDRESS}",
"createdTime" : 1520458807291,
"createdUserId" : "{USER-ID}",
"desc" : "Agent API Key for this project",
"key" : "{AGENT-API-KEY}"
}

Volver

Recuperar para un proyecto

En esta página