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
-
24String exclusiva de dí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_AUDIT
ouALERT_UNACKNOWLEDGED_AUDIT
.Os valores são
ALERT_CONFIG_DISABLED_AUDIT
,ALERT_CONFIG_ENABLED_AUDIT
,ALERT_CONFIG_ADDED_AUDIT
,ALERT_CONFIG_DELETED_AUDIT
ouALERT_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_ENABLED
ouAPI_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_ENABLED
ouSERVICE_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
,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
ouEVERGREEN_PRIORITY_MODIFIED
.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_UPDATED
ouROLE_MAPPING_DELETED
.Os valores são
GROUP_DELETED
,GROUP_CREATED
ouGROUP_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_SELECTED
ouMLAB_MIGRATION_SUPPORT_PLAN_OPTED_OUT
.O valor é
ORG_LIMIT_UPDATED
.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
,GROUP_MOVED_FROM_ORG
,SANDBOX_ENABLED_FOR_ORG
ouSANDBOX_DISABLED_FOR_ORG
.Os valores são
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_PAID
ouVERCEL_INVOICE_REFUNDED
.Os valores são
SUPPORT_EMAILS_SENT_SUCCESSFULLY
ouSUPPORT_EMAILS_SENT_FAILURE
.Os valores são
TEAM_CREATED
,TEAM_DELETED
,TEAM_UPDATED
,TEAM_NAME_CHANGED
,TEAM_ADDED_TO_GROUP
,TEAM_REMOVED_FROM_GROUP
ouTEAM_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_FAILED
ouINVITED_TO_TEAM
.Os valores são
TAGS_MODIFIED
ouGROUP_TAGS_MODIFIED
.Os valores são
RESOURCE_POLICY_CREATED
,RESOURCE_POLICY_MODIFIED
,RESOURCE_POLICY_DELETED
ouRESOURCE_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/v20241023001/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-10-23+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-10-23+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"
}