Retornar eventos de uma organização
Retorna eventos para a organização especificada . Os eventos identificam atividades significativas de banco de dados, de faturamento ou de segurança ou alterações de status. Para usar esse recurso, a conta de serviço ou a chave de API solicitante deve ter a role de nó da organização.
Este recurso permanece sob revisão e pode mudar.
parâmetros de caminho
-
String exclusiva de 24dígitos hexadecimais que identifica a organização que contém seus projetos. Use o endpoint /orgs para recuperar todas as organizações às quais o usuário autenticado tem acesso.
O formato deve corresponder ao seguinte padrão:
^([a-f0-9]{24})$.
parâmetros de query
-
Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON
envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na consulta. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta.O valor padrão é
false. -
Sinalizador que indica se a resposta retorna o número total de itens (totalCount) na resposta.
O valor padrão é
true. -
Número de itens que a resposta retorna por página.
O valor mínimo é
1, o valor máximo é500. O valor padrão é100. -
Número da página que exibe o conjunto atual dos objetos totais que a resposta retorna.
O valor mínimo é
1. O valor padrão é1. -
Sinalizador que indica se o corpo da resposta deve estar no formato prettyprint.
O valor padrão é
false.Prettyprint -
Categoria de incidente registrada neste ponto temporal.
IMPORTANTE: a lista completa de valores do tipo de evento muda com frequência.
Um dos seguintes: String de tipos de auditoria de alertaString de tipos de auditoria de alertastring de Tipos de Eventos de Usuário da APIstring de tipos de eventos de conta de serviçostring de Tipos de Evento de Faturamentostring Tipos de eventos de configurações de federaçãoString de tipos de auditoria de grupostring de Tipos de Auditoria de Migração MLabstring de Tipos de Auditoria NDSString de tipos de eventos organizacionaisString de tipos de eventos de parceirosString de tipos de eventos de suporteString de tipos de eventos de equipestring de Tipos de Evento do Usuáriostring de tipos de eventos de recursos Tipos de auditoria da política de recursos do Atlasstring Os valores são
ALERT_ACKNOWLEDGED_AUDITouALERT_UNACKNOWLEDGED_AUDIT.Os valores são
ALERT_CONFIG_DISABLED_AUDIT,ALERT_CONFIG_ENABLED_AUDIT,ALERT_CONFIG_ADDED_AUDIT,ALERT_CONFIG_DELETED_AUDITouALERT_CONFIG_CHANGED_AUDIT.Os valores são
API_KEY_CREATED,API_KEY_DELETED,API_KEY_ACCESS_LIST_ENTRY_ADDED,API_KEY_ACCESS_LIST_ENTRY_DELETED,API_KEY_ROLES_CHANGED,API_KEY_DESCRIPTION_CHANGED,API_KEY_ADDED_TO_GROUP,API_KEY_REMOVED_FROM_GROUP,API_KEY_UI_IP_ACCESS_LIST_INHERITANCE_ENABLEDouAPI_KEY_UI_IP_ACCESS_LIST_INHERITANCE_DISABLED.Os valores são
SERVICE_ACCOUNT_CREATED,SERVICE_ACCOUNT_DELETED,SERVICE_ACCOUNT_ROLES_CHANGED,SERVICE_ACCOUNT_DETAILS_CHANGED,SERVICE_ACCOUNT_ADDED_TO_GROUP,SERVICE_ACCOUNT_REMOVED_FROM_GROUP,SERVICE_ACCOUNT_ACCESS_LIST_ENTRY_ADDED,SERVICE_ACCOUNT_ACCESS_LIST_ENTRY_DELETED,SERVICE_ACCOUNT_SECRET_ADDED,SERVICE_ACCOUNT_SECRET_DELETED,SERVICE_ACCOUNT_UI_IP_ACCESS_LIST_INHERITANCE_ENABLEDouSERVICE_ACCOUNT_UI_IP_ACCESS_LIST_INHERITANCE_DISABLED.Os valores são
CHARGE_SUCCEEDED,CHARGE_FAILED,CHARGE_PROCESSING,CHARGE_PENDING_REVERSAL,BRAINTREE_CHARGE_FAILED,INVOICE_CLOSED,CHECK_PAYMENT_RECEIVED,WIRE_TRANSFER_PAYMENT_RECEIVED,DISCOUNT_APPLIED,CREDIT_ISSUED,CREDIT_PULLED_FWD,CREDIT_END_DATE_MODIFIED,PROMO_CODE_APPLIED,PAYMENT_FORGIVEN,REFUND_ISSUED,ACCOUNT_DOWNGRADED,ACCOUNT_UPGRADED,ACCOUNT_MODIFIED,SUPPORT_PLAN_ACTIVATED,SUPPORT_PLAN_CANCELLED,SUPPORT_PLAN_CANCELLATION_SCHEDULED,INITIATE_SALESFORCE_SERVICE_CLOUD_SYNC,INVOICE_ADDRESS_CHANGED,INVOICE_ADDRESS_ADDED,PREPAID_PLAN_ACTIVATED,ELASTIC_INVOICING_MODE_ACTIVATED,ELASTIC_INVOICING_MODE_DEACTIVATED,TERMINATE_PAID_SERVICES,BILLING_EMAIL_ADDRESS_ADDED,BILLING_EMAIL_ADDRESS_CHANGED,BILLING_EMAIL_ADDRESS_REMOVED,AWS_BILLING_ACCOUNT_CREDIT_ISSUED,GCP_BILLING_ACCOUNT_CREDIT_ISSUED,CREDIT_SFOLID_MODIFIED,PREPAID_PLAN_MODIFIED,AWS_USAGE_REPORTED,AZURE_USAGE_REPORTED,GCP_USAGE_REPORTED,VERCEL_USAGE_REPORTED,BECAME_PAYING_ORG,BECAME_LINKED_ORG,NEW_LINKED_ORG,UNLINKED_ORG,ORG_LINKED_TO_PAYING_ORG,ORG_UNLINKED_FROM_PAYING_ORG,ORG_UNLINK_REQUESTED,ORG_UNLINK_CANCELLED,PAYMENT_UPDATED_THROUGH_API,AZURE_BILLING_ACCOUNT_CREDIT_ISSUED,CREDIT_START_DATE_MODIFIED,CREDIT_ELASTIC_INVOICING_MODIFIED,CREDIT_TYPE_MODIFIED,CREDIT_AMOUNT_CENTS_MODIFIED,CREDIT_AMOUNT_REMAINING_CENTS_MODIFIED,CREDIT_TOTAL_BILLED_CENTS_MODIFIED,CREDIT_AWS_CUSTOMER_ID_MODIFIED,CREDIT_AWS_PRODUCT_CODE_MODIFIED,CREDIT_GCP_MARKETPLACE_ENTITLEMENT_ID_MODIFIED,CREDIT_AZURE_SUBSCRIPTION_ID_MODIFIED,CREDIT_AZURE_PRIVATE_PLAN_ID_MODIFIED,TARGETED_REBILL_EXECUTED,LEGACY_REBILL_EXECUTED,EVERGREEN_DEAL_CANCELLED,GRACE_PERIOD_ACTIVATED,GRACE_PERIOD_NO_LONGER_IN_EFFECT,PENDING_DEAL_ACTIVATION_ADDED,PENDING_DEAL_ACTIVATION_CANCELED,PENDING_DEAL_APPLIED,PENDING_DEAL_ACTIVATION_FAILED,EVERGREEN_PRIORITY_MODIFIEDouCROSS_ORG_OPERATION_TICKET_TRACKING.Os valores são
FEDERATION_SETTINGS_CREATED,FEDERATION_SETTINGS_DELETED,FEDERATION_SETTINGS_UPDATED,IDENTITY_PROVIDER_CREATED,IDENTITY_PROVIDER_UPDATED,IDENTITY_PROVIDER_DELETED,IDENTITY_PROVIDER_ACTIVATED,OIDC_IDENTITY_PROVIDER_UPDATED,IDENTITY_PROVIDER_DEACTIVATED,IDENTITY_PROVIDER_JWKS_REVOKED,OIDC_IDENTITY_PROVIDER_ENABLED,OIDC_IDENTITY_PROVIDER_DISABLED,DOMAINS_ASSOCIATED,DOMAIN_CREATED,DOMAIN_DELETED,DOMAIN_VERIFIED,ORG_SETTINGS_CONFIGURED,ORG_SETTINGS_UPDATED,ORG_SETTINGS_DELETED,RESTRICT_ORG_MEMBERSHIP_ENABLED,RESTRICT_ORG_MEMBERSHIP_DISABLED,ROLE_MAPPING_CREATED,ROLE_MAPPING_UPDATEDouROLE_MAPPING_DELETED.Os valores são
GROUP_DELETED,GROUP_CREATEDouGROUP_MOVED.Os valores são
MLAB_MIGRATION_COMPLETED,MLAB_MIGRATION_TARGET_CLUSTER_CREATED,MLAB_MIGRATION_DATABASE_USERS_IMPORTED,MLAB_MIGRATION_IP_WHITELIST_IMPORTED,MLAB_MIGRATION_TARGET_CLUSTER_SET,MLAB_MIGRATION_DATABASE_RENAMED,MLAB_MIGRATION_LIVE_IMPORT_STARTED,MLAB_MIGRATION_LIVE_IMPORT_READY_FOR_CUTOVER,MLAB_MIGRATION_LIVE_IMPORT_CUTOVER_COMPLETE,MLAB_MIGRATION_LIVE_IMPORT_ERROR,MLAB_MIGRATION_LIVE_IMPORT_CANCELLED,MLAB_MIGRATION_DUMP_AND_RESTORE_TEST_STARTED,MLAB_MIGRATION_DUMP_AND_RESTORE_TEST_SKIPPED,MLAB_MIGRATION_DUMP_AND_RESTORE_STARTED,MLAB_MIGRATION_SUPPORT_PLAN_SELECTEDouMLAB_MIGRATION_SUPPORT_PLAN_OPTED_OUT.Os valores são
ORG_LIMIT_UPDATED,SHADOW_CLUSTER_ORG_OPT_INouSHADOW_CLUSTER_ORG_OPT_OUT.Os valores são
ORG_CREATED,CUSTOM_SESSION_TIMEOUT_MODIFIED,SECURITY_CONTACT_MODIFIED,ORG_CREDIT_CARD_ADDED,ORG_CREDIT_CARD_UPDATED,ORG_CREDIT_CARD_CURRENT,ORG_CREDIT_CARD_ABOUT_TO_EXPIRE,ORG_PAYPAL_LINKED,ORG_PAYPAL_UPDATED,ORG_PAYPAL_CANCELLED,ORG_OVERRIDE_PAYMENT_METHOD_ADDED,ORG_ACTIVATED,ORG_TEMPORARILY_ACTIVATED,ORG_SUSPENSION_DATE_CHANGED,ORG_SUSPENDED,ORG_ADMIN_SUSPENDED,ORG_ADMIN_LOCKED,ORG_CLUSTERS_DELETED,ORG_CLUSTERS_PAUSED,ORG_LOCKED,ORG_UNDER_FINANCIAL_PROTECTION,ORG_NO_FINANCIAL_PROTECTION,ORG_RENAMED,ALL_ORG_USERS_HAVE_MFA,ORG_USERS_WITHOUT_MFA,ORG_INVOICE_UNDER_THRESHOLD,ORG_INVOICE_OVER_THRESHOLD,ORG_DAILY_BILL_UNDER_THRESHOLD,ORG_DAILY_BILL_OVER_THRESHOLD,ORG_GROUP_CHARGES_UNDER_THRESHOLD,ORG_GROUP_CHARGES_OVER_THRESHOLD,ORG_TWO_FACTOR_AUTH_REQUIRED,ORG_TWO_FACTOR_AUTH_OPTIONAL,ORG_PUBLIC_API_ACCESS_LIST_REQUIRED,ORG_PUBLIC_API_ACCESS_LIST_NOT_REQUIRED,ORG_EMPLOYEE_ACCESS_RESTRICTED,ORG_EMPLOYEE_ACCESS_UNRESTRICTED,ORG_SFDC_ACCOUNT_ID_CHANGED,ORG_CONNECTED_TO_MLAB,ORG_DISCONNECTED_FROM_MLAB,ORG_IDP_CERTIFICATE_CURRENT,ORG_IDP_CERTIFICATE_ABOUT_TO_EXPIRE,ORG_CONNECTED_TO_VERCEL,ORG_DISCONNECTED_TO_VERCEL,ORG_CONNECTION_UNINSTALLED_FROM_VERCEL,ORG_UI_IP_ACCESS_LIST_ENABLED,ORG_UI_IP_ACCESS_LIST_DISABLED,ORG_EDITED_UI_IP_ACCESS_LIST_ENTRIES,ORG_SERVICE_ACCOUNT_MAX_SECRET_VALIDITY_EDITED,ORG_SERVICE_ACCOUNT_SECRETS_EXPIRED,ORG_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRED,ORG_SERVICE_ACCOUNT_SECRETS_EXPIRING,ORG_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRING,ORG_MONGODB_VERSION_EOL_EXTENSION_ACCEPTED,ORG_MONGODB_VERSION_EOL_EXTENSION_PENDING,ORG_MONGODB_VERSION_EOL_EXTENSION_CANCELLED,ORG_BAAS_EOL_EXTENSION_ACCEPTED,ORG_BAAS_EOL_EXTENSION_PENDING,ORG_BAAS_EOL_EXTENSION_CANCELED,GROUP_MOVED_FROM_ORG,SANDBOX_ENABLED_FOR_ORG,SANDBOX_DISABLED_FOR_ORG,SANDBOX_CONFIG_DELETED,SANDBOX_TEMPLATE_UPDATED,ORGANIZATION_VOYAGE_SETTINGS_CREATEDouORGANIZATION_VOYAGE_SETTINGS_DELETED.Os valores são
AWS_PAYMENT_PAID,AWS_SELF_SERVE_ACCOUNT_LINKED,AWS_SELF_SERVE_ACCOUNT_LINK_PENDING,AWS_SELF_SERVE_ACCOUNT_CANCELLED,AWS_SELF_SERVE_ACCOUNT_LINK_FAILED,GCP_SELF_SERVE_ACCOUNT_LINK_PENDING,GCP_SELF_SERVE_ACCOUNT_LINK_FAILED,AZURE_SELF_SERVE_ACCOUNT_LINKED,AZURE_SELF_SERVE_ACCOUNT_LINK_PENDING,AZURE_SELF_SERVE_ACCOUNT_CANCELLED,AZURE_SELF_SERVE_ACCOUNT_LINK_FAILED,GCP_SELF_SERVE_ACCOUNT_LINKED,GCP_SELF_SERVE_ACCOUNT_CANCELLED,VERCEL_SELF_SERVE_ACCOUNT_LINKED,VERCEL_SELF_SERVE_ACCOUNT_LINK_PENDING,VERCEL_SELF_SERVE_ACCOUNT_CANCELLED,VERCEL_SELF_SERVE_ACCOUNT_LINK_FAILED,VERCEL_INVOICE_CREATED,VERCEL_INVOICE_NOT_PAID,VERCEL_INVOICE_PAIDouVERCEL_INVOICE_REFUNDED.Os valores são
SUPPORT_EMAILS_SENT_SUCCESSFULLYouSUPPORT_EMAILS_SENT_FAILURE.Os valores são
TEAM_CREATED,TEAM_DELETED,TEAM_UPDATED,TEAM_NAME_CHANGED,TEAM_ADDED_TO_GROUP,TEAM_REMOVED_FROM_GROUPouTEAM_ROLES_MODIFIED.Os valores são
JOINED_ORG,JOINED_TEAM,INVITED_TO_ORG,ORG_INVITATION_DELETED,REMOVED_FROM_ORG,REMOVED_FROM_TEAM,USER_ROLES_CHANGED_AUDIT,ORG_FLEX_CONSULTING_PURCHASED,ORG_FLEX_CONSULTING_PURCHASE_FAILEDouINVITED_TO_TEAM.Os valores são
TAGS_MODIFIEDouGROUP_TAGS_MODIFIED.Os valores são
RESOURCE_POLICY_CREATED,RESOURCE_POLICY_MODIFIED,RESOURCE_POLICY_DELETEDouRESOURCE_POLICY_VIOLATED. -
Sinalizador que indica se o documento bruto deve ser incluído na saída. O documento bruto contém metainformações adicionais sobre o evento.
O valor padrão é
false. -
Data e hora a partir de quando o MongoDB Cloud para de retornar eventos. Este parâmetro utiliza o formato de carimbo de data/hora ISO 8601 em UTC.
ISO 8601 -
Data e hora de quando o MongoDB Cloud começa a retornar eventos. Este parâmetro utiliza o formato de carimbo de data/hora ISO 8601 em UTC.
ISO 8601
atlas api events listOrgEvents --help
import (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20240530001/admin"
)
func main() {
ctx := context.Background()
clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")
// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))
if err != nil {
log.Fatalf("Error: %v", err)
}
params = &sdk.ListOrgEventsApiParams{}
sdkResp, httpResp, err := client.EventsApi.
ListOrgEventsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/events?pretty=true"
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/events?pretty=true"
{
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"results": [
{
"apiKeyId": "32b6e34b3d91647abb20e7b8",
"created": "2025-05-04T09:42:00Z",
"eventTypeName": "FEDERATION_SETTINGS_CREATED",
"groupId": "32b6e34b3d91647abb20e7b8",
"id": "32b6e34b3d91647abb20e7b8",
"isGlobalAdmin": true,
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"orgId": "32b6e34b3d91647abb20e7b8",
"publicKey": "string",
"raw": {
"_t": "ALERT_AUDIT",
"alertConfigId": "32b6e34b3d91647abb20e7b8",
"cid": "32b6e34b3d91647abb20e7b8",
"cre": "2025-05-04T09:42:00Z",
"description": "Alert Acknowledged",
"gn": "Test Project",
"id": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"orgName": "Test Organization",
"severity": "INFO"
},
"remoteAddress": "216.172.40.186",
"userId": "32b6e34b3d91647abb20e7b8",
"username": "hello@example.com"
}
],
"totalCount": 42
}
{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}
{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}
{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}
{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}