从一个组织返回事件
返回指定组织的事件。事件用于标识重要的数据库、计费或安全活动或状态更改。要使用此资源,请求的服务帐户或API密钥必须具有“组织成员”角色。
此资源仍在修订中,可能会有变动。
路径参数
-
唯一的 24-十六进制数字字符串,用于标识包含项目的组织。 使用 /orgs 端点检索身份验证的用户有权访问权限的所有组织。
格式应符合以下模式:
^([a-f0-9]{24})$。
查询参数
-
指示应用程序是否将响应包装在
envelopeJSON 对象中的标志。某些 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、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_MODIFIED或CROSS_ORG_OPERATION_TICKET_TRACKING。值为
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、SHADOW_CLUSTER_ORG_OPT_IN或SHADOW_CLUSTER_ORG_OPT_OUT。值为
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_CREATED或ORGANIZATION_VOYAGE_SETTINGS_DELETED。值为
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_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/v20231001001/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-10-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-10-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"
}