从一个组织返回事件
返回指定组织的事件。事件用于标识重要的数据库、计费或安全活动或状态更改。要使用此资源,请求的服务帐户或API密钥必须具有“组织成员”角色。
此资源仍在修订中,可能会有变动。
路径参数
-
唯一的24 -十六进制数字字符串,用于标识包含项目的组织。使用 /orgs 端点检索身份验证的用户有权访问权限的所有组织。
格式应符合以下模式:
^([a-f0-9]{24})$
。
查询参数
-
指示应用程序是否将响应包装在
envelope
JSON 对象中的标志。某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题,请在查询中设置 Envelope=true。返回结果列表的端点将结果对象用作 envelope。应用程序将状态参数添加到响应正文中。默认值为
false
。 -
标志,用于指示响应是否返回响应中的列项总数 (totalCount)。
默认值为
true
。 -
响应每页返回的列项数。
最小值为
1
,最大值为500
。默认值为100
。 -
显示响应返回的当前总对象集的页面编号。
最小值为
1
。默认值为1
。 -
指示响应正文是否应采用 prettyprint 格式的标记。
默认值为
false
。Prettyprint -
此时记录的事件类别。
重要提示:事件类型值的完整列表经常更改。
以下之一: 值为
ALERT_ACKNOWLEDGED_AUDIT
或ALERT_UNACKNOWLEDGED_AUDIT
。取值为
ALERT_CONFIG_DISABLED_AUDIT
、ALERT_CONFIG_ENABLED_AUDIT
、ALERT_CONFIG_ADDED_AUDIT
、ALERT_CONFIG_DELETED_AUDIT
或ALERT_CONFIG_CHANGED_AUDIT
。取值为
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
或API_KEY_UI_IP_ACCESS_LIST_INHERITANCE_DISABLED
。值为
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
或SERVICE_ACCOUNT_UI_IP_ACCESS_LIST_INHERITANCE_DISABLED
。值为
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
或EVERGREEN_PRIORITY_MODIFIED
。值为
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
或ROLE_MAPPING_DELETED
。值为
GROUP_DELETED
、GROUP_CREATED
或GROUP_MOVED
。值为
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
或MLAB_MIGRATION_SUPPORT_PLAN_OPTED_OUT
。值为
ORG_LIMIT_UPDATED
。值为
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
或SANDBOX_DISABLED_FOR_ORG
。值为
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
或VERCEL_INVOICE_REFUNDED
。值为
SUPPORT_EMAILS_SENT_SUCCESSFULLY
或SUPPORT_EMAILS_SENT_FAILURE
。取值为
TEAM_CREATED
、TEAM_DELETED
、TEAM_UPDATED
、TEAM_NAME_CHANGED
、TEAM_ADDED_TO_GROUP
、TEAM_REMOVED_FROM_GROUP
或TEAM_ROLES_MODIFIED
。取值为
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
或INVITED_TO_TEAM
。值为
TAGS_MODIFIED
或GROUP_TAGS_MODIFIED
。取值为
RESOURCE_POLICY_CREATED
、RESOURCE_POLICY_MODIFIED
、RESOURCE_POLICY_DELETED
或RESOURCE_POLICY_VIOLATED
。 -
指示是否在输出中包含原始文档的标记。原始文档包含有关事件的其他元信息。
默认值为
false
。 -
MongoDB Cloud 停止返回事件的日期和时间。此参数使用 UTC 格式的 ISO 8601 时间戳格式。
ISO 8601 -
MongoDB Cloud 开始返回事件的日期和时间。此参数使用 UTC 格式的 ISO 8601 时间戳格式。
ISO 8601
atlas api events listOrgEvents --help
import (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20230201001/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.2023-02-01+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.2023-02-01+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"
}