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 organización
Use la API de organización para trabajar con organizaciones en un espacio de trabajo de Amazon Managed Grafana.
**nota**
Para usar una API de Grafana con su espacio de trabajo de Amazon Managed Grafana, debe tener un token de API de Grafana que sea válido. Lo incluye en el campo `Authorization` de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar sus llamadas a la API, consulte [Autenticación con tokens](authenticating-grafana-apis.md).
## Obtención de la organización actual
```
GET /api/org/
```
**Ejemplo de solicitud**
```
GET /api/org/ HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{
"id":1,
"name":"Main Org."
}
```
## Obtención de todos los usuarios de la organización actual
```
GET /api/org/users
```
Permisos obligatorios: la acción `org.users:read` con el alcance `users:*`
**Ejemplo de solicitud**
```
GET /api/org/users HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
[
{
"orgId": 1,
"userId": 1,
"email": "admin@localhost",
"avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae",
"login": "admin",
"role": "Admin",
"lastSeenAt": "2019-08-09T11:02:49+02:00",
"lastSeenAtAge": "< 1m"
}
]
```
## Obtención de todos los usuarios de la organización actual (búsqueda)
```
GET /api/org/users/lookup
```
Devuelve todos los usuarios de la organización actual, pero con información menos detallada. Accesible para los usuarios con el rol de administrador de la organización, administrador de cualquier carpeta o administrador de cualquier equipo. Se utiliza principalmente en la interfaz de usuario de Grafana para proporcionar una lista de usuarios al añadir miembros del equipo y al editar los permisos. folder/dashboard
**Ejemplo de solicitud**
```
GET /api/org/users/lookup HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
[
{
"userId": 1,
"login": "admin",
"avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae"
}
]
```
## Actualización del usuario indicado
```
PATCH /api/org/users/:userId
```
Permisos obligatorios: la acción `org.users.role:update` con el alcance `users:*`
**Ejemplo de solicitud**
```
PATCH /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"role": "Viewer",
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"message":"Organization user updated"}
```
## Eliminación del usuario de la organización actual
```
DELETE /api/org/users/:userId
```
Permisos obligatorios: la acción `org.users:remove` con el alcance `users:*`
**Ejemplo de solicitud**
```
DELETE /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"message":"User removed from organization"}
```
## Actualización de la organización actual
```
PUT /api/org
```
**Ejemplo de solicitud**
```
PUT /api/org HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"name":"Main Org."
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"message":"Organization updated"}
```
## Cómo agregar un usuario a la organización actual
```
POST /api/org/users
```
Permisos obligatorios: la acción `org.users:add` con el alcance `users:*`
**Ejemplo de solicitud**
```
POST /api/org/users HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"role": "Admin",
"loginOrEmail": "admin"
}
```
**Ejemplo de respuesta**
```
HTTP/1.1 200
Content-Type: application/json
{"message":"User added to organization","userId":1}
```