Recupera un recibo firmado que confirma que liberaste una clave de licencia de una instalación de Ops Manager. Ops Manager solo devuelve un recibo para una clave de licencia liberada. La interfaz Ops Manager ofrece el mismo recibo que una descarga.
Guarda el recibo como prueba de la liberación. Si tu instalación no puede conectarse a MongoDB, sube el recibo en el Key Portal en https://support.mongodb.com/keyportal.
Roles necesarios
Para acceder a este recurso, tu clave API debe tener el rolGlobal Owner. El rol de Propietario Global es el rol más alto en Ops Manager. Solo los usuarios con este rol pueden ver y gestionar las claves de licencia.
Solicitud
Envía una solicitud de GET con el ID de la clave de licencia en la ruta.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /admin/artifacts/{artifactId}/receiptParámetros de ruta de solicitud
La ruta de solicitud contiene el siguiente parámetro:
Parameter | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | Identificador único de la clave de licencia liberada. |
Parámetros de Solicitud Query
Este punto final acepta los siguientes parámetros de consulta:
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
envelope | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
La respuesta contiene el siguiente campo:
Campo | Tipo | Descripción |
|---|---|---|
| Objeto | Acuse de recibo de liberación para la clave de licencia, devuelto como documento JSON. |
Errors
Si especificas un artifactId que no coincide con una clave de licencia liberada, el endpoint devuelve el estado HTTP 404. El campo errorCode del cuerpo de respuesta contiene ARTIFACT_NOT_FOUND, y el campo detail contiene No released artifact with that id.
Solicitud de ejemplo
Usa curl para enviar una petición GET al endpoint /admin/artifacts/{artifactId}/receipt :
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/artifacts/{ARTIFACT-ID}/receipt?pretty=true"Respuesta de ejemplo
Los siguientes ejemplos muestran los encabezados de respuesta y el cuerpo de respuesta de una solicitud exitosa.
Encabezado de respuesta
Los siguientes encabezados muestran una respuesta no autorizada y una respuesta exitosa:
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-aliveHTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Respuesta del cuerpo
El siguiente ejemplo muestra el cuerpo de respuesta:
{ "receipt": { "{RECEIPT-CONTENTS}": "..." }}