Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# API de complementos
Use la API de complementos para administrar complementos en el espacio de trabajo de Amazon Managed Grafana. Para hacer cambios en los complementos con esta API, el espacio de trabajo debe tener [habilitada la administración de complementos](AMG-configure-workspace.md) para su espacio de trabajo. El usuario definido por la clave de API de Grafana también debe ser [administrador](Grafana-user-roles.md) del espacio de trabajo de Amazon Managed Grafana.
**nota**
Para usar una API de Grafana con tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de cuenta de servicio válido. Lo incluye en el campo `Authorization` de la solicitud de API.
## Instalación de un complemento
```
POST /api/plugins/:id/install
```
**Ejemplo de solicitud**
```
POST /api/plugins/grafana-athena-datasource/install HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"version": "2.12.0" # optional, uses the latest compatible version if not provided
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
```
## Desinstalación de un complemento
```
POST /api/plugins/:id/uninstall
```
**Ejemplo de solicitud**
```
POST /api/plugins/grafana-athena-datasource/uninstall HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"version": "2.12.0" # optional, uninstalls whatever is installed if not provided
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
```
## Obtención de todos los complementos
```
GET /api/gnet/plugins
```
**Ejemplo de solicitud**
```
GET /api/gnet/plugins HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{
"items": [
{
"status": "active",
"id": 74,
"typeId": 1,
"typeName": "Application",
"typeCode": "app",
"slug": "alexanderzobnin-zabbix-app",
"name": "Zabbix",
"description": "Zabbix plugin for Grafana",
"version": "4.4.3",
"versionStatus": "active",
"versionSignatureType": "grafana",
"versionSignedByOrg": "grafana",
"versionSignedByOrgName": "Grafana Labs",
"userId": 0,
"orgId": 13056,
"orgName": "Alexander Zobnin",
"orgSlug": "alexanderzobnin",
"orgUrl": "https://github.com/alexanderzobnin",
"url": "https://github.com/grafana/grafana-zabbix/",
"createdAt": "2016-04-06T20:23:41.000Z",
"updatedAt": "2023-10-10T12:53:51.000Z",
"downloads": 90788771,
"verified": false,
"featured": 180,
"internal": false,
"downloadSlug": "alexanderzobnin-zabbix-app",
"popularity": 0.2485,
"signatureType": "grafana",
"packages": {
"linux-amd64": {
"md5": "baa06e8f26731f99748c58522cd4ffb6",
"sha256": "a4a108f2e04a2114810c7b60419b4b04bf80d3377e2394b0586e2dc96b5a929c",
"packageName": "linux-amd64",
"downloadUrl": "/api/plugins/alexanderzobnin-zabbix-app/versions/4.4.3/download?os=linux&arch=amd64"
},
{{<... further packages>}}
},
"links": [
{
"rel": "self",
"href": "/plugins/alexanderzobnin-zabbix-app"
},
{{<... further links>}}
],
"angularDetected": false
},
{{<... further plugins>}}
],
"orderBy": "weight",
"direction": "asc",
"links": [
{
"rel": "self",
"href": "/plugins"
}
]
}
```
## Obtención de un complemento
```
GET /api/gnet/plugins/:id
```
**Ejemplo de solicitud**
```
GET /api/gnet/plugins/grafana-athena-datasource HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{
"status": "active",
"id": 764,
"typeId": 2,
"typeName": "Data Source",
"typeCode": "datasource",
"slug": "grafana-athena-datasource",
"name": "Amazon Athena",
"description": "Use Amazon Athena with Grafana",
"version": "2.13.0",
"versionStatus": "active",
"versionSignatureType": "grafana",
"versionSignedByOrg": "grafana",
"versionSignedByOrgName": "Grafana Labs",
"userId": 0,
"orgId": 5000,
"orgName": "Grafana Labs",
"orgSlug": "grafana",
"orgUrl": "https://grafana.org",
"url": "https://github.com/grafana/athena-datasource/",
"createdAt": "2021-11-24T08:55:41.000Z",
"updatedAt": "2023-10-31T17:20:32.000Z",
"json": {
"$schema": "https://raw.githubusercontent.com/grafana/grafana/master/docs/sources/developers/plugins/plugin.schema.json",
"alerting": true,
"annotations": true,
"backend": true,
"dependencies": {
"grafanaDependency": ">=8.0.0",
"plugins": []
},
"executable": "gpx_athena",
"id": "grafana-athena-datasource",
"includes": [
{
"name": "Cost Usage Report Monitoring",
"path": "dashboards/cur-monitoring.json",
"type": "dashboard"
},
{
"name": "Amazon VPC Flow Logs",
"path": "dashboards/vpc-flow-logs.json",
"type": "dashboard"
}
],
"info": {
"author": {
"name": "Grafana Labs",
"url": "https://grafana.com"
},
"build": {
"time": 1698764559022,
"repo": "https://github.com/grafana/athena-datasource",
"branch": "main",
"hash": "25cc131300f1ed22593bc3ba08b2bef7d23fbcd01",
"build": 1462
},
"description": "Use Amazon Athena with Grafana",
"keywords": [
"datasource",
"athena"
],
"links": [
{
"name": "Website",
"url": "https://github.com/grafana/athena-datasource"
},
{
"name": "License",
"url": "https://github.com/grafana/athena-datasource/blob/master/LICENSE"
}
],
"logos": {
"large": "img/logo.svg",
"small": "img/logo.svg"
},
"screenshots": [],
"updated": "2023-10-31",
"version": "2.13.0"
},
"metrics": true,
"name": "Amazon Athena",
"type": "datasource"
},
"readme": "{{<... full HTML readme>}}",
"statusContext": "",
"downloads": 2505825,
"verified": false,
"featured": 0,
"internal": false,
"downloadSlug": "grafana-athena-datasource",
"popularity": 0.0594,
"signatureType": "grafana",
"grafanaDependency": ">=8.0.0",
"packages": {
"linux-amd64": {
"md5": "7efef359bf917b4ca6b149de42a1282d",
"sha256": "cd2fc5737c321dc3d8bbe2852c801c01adb64eacc9f60420bd21dc18bee43531",
"packageName": "linux-amd64",
"downloadUrl": "/api/plugins/grafana-athena-datasource/versions/2.13.0/download?os=linux&arch=amd64"
},
{{<... other packages>}}
},
"links": [
{
"rel": "self",
"href": "/plugins/grafana-athena-datasource"
},
{{<... other links>}}
],
"angularDetected": false
}
```
## Obtención de las versiones de un complemento
```
POST /api/gnet/plugins/:id/versions
```
**Ejemplo de solicitud**
```
GET /api/gnet/plugins/grafana-athena-datasource/versions HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{
"items": [
{
"id": 5306,
"pluginId": 764,
"pluginSlug": "grafana-athena-datasource",
"version": "2.13.0",
"url": "https://github.com/grafana/athena-datasource/",
"commit": "",
"description": "Use Amazon Athena with Grafana",
"createdAt": "2023-10-31T17:20:31.000Z",
"updatedAt": null,
"downloads": 33790,
"verified": false,
"status": "active",
"statusContext": "",
"downloadSlug": "grafana-athena-datasource",
"packages": {},
"links": [
{
"rel": "self",
"href": "/plugins/grafana-athena-datasource/versions/2.13.0"
},
{
"rel": "images",
"href": "/plugins/grafana-athena-datasource/versions/2.13.0/images"
},
{
"rel": "thumbnails",
"href": "/plugins/grafana-athena-datasource/versions/2.13.0/thumbnails"
},
{
"rel": "plugin",
"href": "/plugins/grafana-athena-datasource"
},
{
"rel": "download",
"href": "/plugins/grafana-athena-datasource/versions/2.13.0/download"
}
],
"grafanaDependency": ">=8.0.0",
"angularDetected": false
},
{
"id": 5244,
"pluginId": 764,
"pluginSlug": "grafana-athena-datasource",
"version": "2.12.0",
"url": "https://github.com/grafana/athena-datasource/",
"commit": "",
"description": "Use Amazon Athena with Grafana",
"createdAt": "2023-10-17T12:42:13.000Z",
"updatedAt": null,
"downloads": 60742,
"verified": false,
"status": "active",
"statusContext": "",
"downloadSlug": "grafana-athena-datasource",
"packages": {},
"links": [
{
"rel": "self",
"href": "/plugins/grafana-athena-datasource/versions/2.12.0"
},
{
"rel": "images",
"href": "/plugins/grafana-athena-datasource/versions/2.12.0/images"
},
{
"rel": "thumbnails",
"href": "/plugins/grafana-athena-datasource/versions/2.12.0/thumbnails"
},
{
"rel": "plugin",
"href": "/plugins/grafana-athena-datasource"
},
{
"rel": "download",
"href": "/plugins/grafana-athena-datasource/versions/2.12.0/download"
}
],
"grafanaDependency": ">=8.0.0",
"angularDetected": false
},
{{<... other versions>}}
]
}
```