감사 로그 작업 목록 조회
감사 로그 작업 목록 조회
감사 로그 이벤트를 조회할 때 필터로 쓸 수 있도록 네임스페이스의 감사 로그 작업(action) 목록을 반환해요. 이 작업은 조직 액세스 토큰(OAT)에서 발급한 bearer 토큰을 받아요. 토큰은 필요한 리소스 액세스 권한과 범위를 가져야 해요.
출처: 문서
본문
GET /v2/auditlogs/{account}/actions
감사 로그 작업 목록 조회 작업이에요. 감사 로그 이벤트를 조회할 때 필터로 쓸 수 있도록 네임스페이스의 감사 로그 작업(action) 목록을 반환해요. 이 작업은 조직 액세스 토큰(OAT)에서 발급한 bearer 토큰을 받아요. 토큰은 필요한 리소스 액세스 권한과 범위를 가져야 해요.
요청 예시
실행 전에 자리 표시자를 바꾸고 필요 자격 증명이나 요청 바디를 채워야 해요.
curl \
--request GET \
--header "Authorization: Bearer ${TOKEN}" \
--header 'Accept: application/json' \
'https://hub.docker.com/v2/auditlogs/<ACCOUNT>/actions'
요청과 응답
응답 200 A successful response.
Schema:
{
"$ref": "#/components/schemas/GetAuditActionsResponse"
}
response:
{
"actions": {
"billing": {
"actions": [
{
"description": "Occurs when your organization’s billing plan is upgraded to a higher tier plan.",
"label": "Plan Upgraded",
"name": "plan.upgrade"
},
{
"description": "Occurs when your organization’s billing plan is downgraded to a lower tier plan.",
"label": "Plan Downgraded",
"name": "plan.downgrade"
},
{
"description": "Occurs when a seat is added to your organization’s billing plan.",
"label": "Seat Added",
"name": "plan.seat_add"
},
{
"description": "Occurs when a seat is removed from your organization’s billing plan.",
"label": "Seat Removed",
"name": "plan.seat_remove"
},
{
"description": "Occurs when there is a change in the recurring interval that your organization is charged.",
"label": "Billing Cycle Changed",
"name": "plan.cycle_change"
},
{
"description": "Occurs when a scheduled plan downgrade for your organization is canceled.",
"label": "Plan Downgrade Canceled",
"name": "plan.downgrade_cancel"
},
{
"description": "Occurs when a scheduled seat removal for an organization’s billing plan is canceled.",
"label": "Seat Removal Canceled",
"name": "plan.seat_removal_cancel"
},
{
"description": "Occurs when a user in your organization requests a plan upgrade.",
"label": "Plan Upgrade Requested",
"name": "plan.upgrade.request"
},
{
"description": "Occurs when a user in your organization requests a plan downgrade.",
"label": "Plan Downgrade Requested",
"name": "plan.downgrade.request"
},
{
"description": "Occurs when a user in your organization requests an increase in the number of seats.",
"label": "Seat Addition Requested",
"name": "plan.seat_add.request"
},
{
"description": "Occurs when a user in your organization requests a decrease in the number of seats.",
"label": "Seat Removal Requested",
"name": "plan.seat_removal.request"
},
{
"description": "Occurs when a user in your organization requests a change in the billing cycle.",
"label": "Billing Cycle Change Requested",
"name": "plan.cycle_change.request"
},
{
"description": "Occurs when a user in your organization requests a cancellation of a scheduled plan downgrade.",
"label": "Plan Downgrade Cancellation Requested",
"name": "plan.downgrade_cancel.request"
},
{
"description": "Occurs when a user in your organization requests a cancellation of a scheduled seat removal.",
"label": "Seat Removal Cancellation Requested",
"name": "plan.seat_removal_cancel.request"
},
{
"description": "Occurs when there is a change in the product that your organization subscribes to.",
"label": "Billing Product Changed",
"name": "plan.product_change"
}
],
"label": "Billing"
},
"enterprise": {
"actions": [
{
"description": "Details of adding an admin settings policy",
"label": "Policy created",
"name": "setting.policy.create"
},
{
"description": "Details of updating an admin settings policy",
"label": "Policy updated",
"name": "setting.policy.update"
},
{
"description": "Details of deleting an admin settings policy",
"label": "Policy deleted",
"name": "setting.policy.delete"
},
{
"description": "Details of transferring an admin settings policy to another owner",
"label": "Policy transferred",
"name": "setting.policy.transfer"
},
{
"description": "Details of creating a new org/company SSO connection",
"label": "Create SSO Connection",
"name": "sso.connection.create"
},
{
"description": "Details of updating an existing org/company SSO connection",
"label": "Update SSO Connection",
"name": "sso.connection.update"
},
{
"description": "Details of deleting an existing org/company SSO connection",
"label": "Delete SSO Connection",
"name": "sso.connection.delete"
},
{
"description": "Details of toggling enforcement on an existing org/company SSO connection",
"label": "Enforce SSO",
"name": "sso.connection.enforcement_toggle"
},
{
"description": "Details of toggling SCIM on an existing org/company SSO connection",
"label": "Enforce SCIM",
"name": "sso.connection.scim_toggle"
},
{
"description": "Details of a SCIM token refresh on an existing org/company SSO connection",
"label": "Refresh SCIM Token",
"name": "sso.connection.scim_token_refresh"
},
{
"description": "Details of a connection type change on an existing org/company SSO connection",
"label": "Change SSO Connection Type",
"name": "sso.connection.connection_type_change"
},
{
"description": "Details of a JIT toggle on an existing org/company SSO connection",
"label": "Toggle JIT provisioning",
"name": "sso.connection.jit_toggle"
}
],
"label": "Enterprise"
},
"offload": {
"actions": [
{
"description": "Details of the started Offload lease.",
"label": "Offload lease start",
"name": "lease.start"
},
{
"description": "Details of the ended Offload lease.",
"label": "Offload lease end",
"name": "lease.end"
}
],
"label": "Offload"
},
"oidc": {
"actions": [
{
"description": "Details of creating an OIDC connection.",
"label": "OIDC connection created",
"name": "connection.create"
},
{
"description": "Details of updating an OIDC connection.",
"label": "OIDC connection updated",
"name": "connection.update"
},
{
"description": "Details of deleting an OIDC connection.",
"label": "OIDC connection deleted",
"name": "connection.delete"
}
],
"label": "OIDC"
},
"org": {
"actions": [
{
"description": "Activities related to the creation of a new organization",
"label": "Organization Created",
"name": "create"
},
{
"description": "Details of the member added to your organization",
"label": "Organization Member Added",
"name": "member.add"
},
{
"description": "Details about the member removed from your organization",
"label": "Organization Member Removed",
"name": "member.remove"
},
{
"description": "Details about the role changed for a member in your organization",
"label": "Member Role Changed",
"name": "member.role.change"
},
{
"description": "Details of the member invited to your organization",
"label": "Org Member Invited",
"name": "member.invite.send"
},
{
"description": "Activities related to the creation of a team",
"label": "Organization Created",
"name": "team.create"
},
{
"description": "Activities related to the modification of a team",
"label": "Organization Deleted",
"name": "team.update"
},
{
"description": "Activities related to the deletion of a team",
"label": "Organization Deleted",
"name": "team.delete"
},
{
"description": "Details of the member added to your team",
"label": "Team Member Added",
"name": "team.member.add"
},
{
"description": "Details of the member removed from your team",
"label": "Team Member Removed",
"name": "team.member.remove"
},
{
"description": "Details of the single sign-on domain added to your organization",
"label": "Single Sign-On domain added",
"name": "domain.create"
},
{
"description": "Details of the single sign-on domain verified for your organization",
"label": "Single Sign-On domain verified",
"name": "domain.verify"
},
{
"description": "Details of the single sign-on domain removed from your organization",
"label": "Single Sign-On domain deleted",
"name": "domain.delete"
},
{
"description": "Details of toggling the Auto-Provisioning feature on a domain on or off",
"label": "Organization Auto-Provisioning Toggled",
"name": "domain.auto-provisioning.toggle"
},
{
"description": "Details related to the organization setting that was updated",
"label": "Organization Settings Updated",
"name": "settings.update"
},
{
"description": "Activities related to enabling Registry Access Management",
"label": "Registry Access Management enabled",
"name": "registry_access.enabled"
},
{
"description": "Activities related to disabling Registry Access Management",
"label": "Registry Access Management disabled",
"name": "registry_access.disabled"
},
{
"description": "Activities related to the addition of a registry",
"label": "Registry Access Management registry added",
"name": "registry_access.registry_added"
},
{
"description": "Details related to the registry that was updated",
"label": "Registry Access Management registry updated",
"name": "registry_access.registry_updated"
},
{
"description": "Activities related to the removal of a registry",
"label": "Registry Access Management registry removed",
"name": "registry_access.registry_removed"
},
{
"description": "Access token created in organization",
"label": "Access token created",
"name": "access_token.create"
},
{
"description": "Access token updated in organization",
"label": "Access token updated",
"name": "access_token.update"
},
{
"description": "Access token deleted in organization",
"label": "Access token deleted",
"name": "access_token.delete"
},
{
"description": "A custom role was created",
"label": "Custom role created",
"name": "customrole.create"
},
{
"description": "An existing custom role was updated",
"label": "Custom role updated",
"name": "customrole.update"
},
{
"description": "A custom role was deleted",
"label": "Custom role deleted",
"name": "customrole.delete"
},
{
"description": "A secure policy configuration was created",
"label": "Secure Policy Configuration created",
"name": "securepolicyconfigure.create"
},
{
"description": "A secure policy configuration was updated",
"label": "Secure Policy Configuration updated",
"name": "securepolicyconfigure.update"
},
{
"description": "A secure policy configuration was deleted",
"label": "Secure Policy Configuration deleted",
"name": "securepolicyconfigure.delete"
},
{
"description": "A secure policy client was created",
"label": "Secure Policy Client created",
"name": "securepolicyclient.create"
},
{
"description": "A secure policy client was updated",
"label": "Secure Policy Client updated",
"name": "securepolicyclient.update"
},
{
"description": "A secure policy client was deleted",
"label": "Secure Policy Client deleted",
"name": "securepolicyclient.delete"
},
{
"description": "A secure policy profile was created",
"label": "Secure Policy Profile created",
"name": "securepolicyprofile.create"
},
{
"description": "A secure policy profile was updated",
"label": "Secure Policy Profile updated",
"name": "securepolicyprofile.update"
},
{
"description": "A secure policy profile was deleted",
"label": "Secure Policy Profile deleted",
"name": "securepolicyprofile.delete"
}
],
"label": "Organization"
},
"repo": {
"actions": [
{
"description": "Activities related to the creation of a new repository",
"label": "Repository Created",
"name": "create"
},
{
"description": "Activities related to the modification of a repository",
"label": "Repository Updated",
"name": "update"
},
{
"description": "Activities related to the deletion of a repository",
"label": "Repository Deleted",
"name": "delete"
},
{
"description": "Details related to the privacy policies that were updated",
"label": "Privacy Changed",
"name": "change_privacy"
},
{
"description": "Details related to updating a repository categories",
"label": "Categories updated",
"name": "category.updated"
},
{
"description": "Details related to updating tag immutability of a repository",
"label": "Tag immutability updated",
"name": "immutable.tags.updated"
},
{
"description": "Activities related to the tags pushed",
"label": "Tag Pushed",
"name": "tag.push"
},
{
"description": "Activities related to the tags deleted",
"label": "Tag Deleted",
"name": "tag.delete"
}
],
"label": "Repository"
}
}
}
응답 429 Schema:
{}
response:
{
"detail": "Rate limit exceeded",
"error": false
}
응답 500 Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "internal error"
}
전체 작업 계약
{
"description": "List audit log actions for a namespace to be used as a filter for querying audit log events.\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "AuditLogs_ListAuditActions",
"parameters": [
{
"description": "Namespace to query audit log actions for.",
"in": "path",
"name": "account",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"examples": {
"response": {
"value": {
"actions": {
"billing": {
"actions": [
{
"description": "Occurs when your organization’s billing plan is upgraded to a higher tier plan.",
"label": "Plan Upgraded",
"name": "plan.upgrade"
},
{
"description": "Occurs when your organization’s billing plan is downgraded to a lower tier plan.",
"label": "Plan Downgraded",
"name": "plan.downgrade"
},
{
"description": "Occurs when a seat is added to your organization’s billing plan.",
"label": "Seat Added",
"name": "plan.seat_add"
},
{
"description": "Occurs when a seat is removed from your organization’s billing plan.",
"label": "Seat Removed",
"name": "plan.seat_remove"
},
{
"description": "Occurs when there is a change in the recurring interval that your organization is charged.",
"label": "Billing Cycle Changed",
"name": "plan.cycle_change"
},
{
"description": "Occurs when a scheduled plan downgrade for your organization is canceled.",
"label": "Plan Downgrade Canceled",
"name": "plan.downgrade_cancel"
},
{
"description": "Occurs when a scheduled seat removal for an organization’s billing plan is canceled.",
"label": "Seat Removal Canceled",
"name": "plan.seat_removal_cancel"
},
{
"description": "Occurs when a user in your organization requests a plan upgrade.",
"label": "Plan Upgrade Requested",
"name": "plan.upgrade.request"
},
{
"description": "Occurs when a user in your organization requests a plan downgrade.",
"label": "Plan Downgrade Requested",
"name": "plan.downgrade.request"
},
{
"description": "Occurs when a user in your organization requests an increase in the number of seats.",
"label": "Seat Addition Requested",
"name": "plan.seat_add.request"
},
{
"description": "Occurs when a user in your organization requests a decrease in the number of seats.",
"label": "Seat Removal Requested",
"name": "plan.seat_removal.request"
},
{
"description": "Occurs when a user in your organization requests a change in the billing cycle.",
"label": "Billing Cycle Change Requested",
"name": "plan.cycle_change.request"
},
{
"description": "Occurs when a user in your organization requests a cancellation of a scheduled plan downgrade.",
"label": "Plan Downgrade Cancellation Requested",
"name": "plan.downgrade_cancel.request"
},
{
"description": "Occurs when a user in your organization requests a cancellation of a scheduled seat removal.",
"label": "Seat Removal Cancellation Requested",
"name": "plan.seat_removal_cancel.request"
},
{
"description": "Occurs when there is a change in the product that your organization subscribes to.",
"label": "Billing Product Changed",
"name": "plan.product_change"
}
],
"label": "Billing"
},
"enterprise": {
"actions": [
{
"description": "Details of adding an admin settings policy",
"label": "Policy created",
"name": "setting.policy.create"
},
{
"description": "Details of updating an admin settings policy",
"label": "Policy updated",
"name": "setting.policy.update"
},
{
"description": "Details of deleting an admin settings policy",
"label": "Policy deleted",
"name": "setting.policy.delete"
},
{
"description": "Details of transferring an admin settings policy to another owner",
"label": "Policy transferred",
"name": "setting.policy.transfer"
},
{
"description": "Details of creating a new org/company SSO connection",
"label": "Create SSO Connection",
"name": "sso.connection.create"
},
{
"description": "Details of updating an existing org/company SSO connection",
"label": "Update SSO Connection",
"name": "sso.connection.update"
},
{
"description": "Details of deleting an existing org/company SSO connection",
"label": "Delete SSO Connection",
"name": "sso.connection.delete"
},
{
"description": "Details of toggling enforcement on an existing org/company SSO connection",
"label": "Enforce SSO",
"name": "sso.connection.enforcement_toggle"
},
{
"description": "Details of toggling SCIM on an existing org/company SSO connection",
"label": "Enforce SCIM",
"name": "sso.connection.scim_toggle"
},
{
"description": "Details of a SCIM token refresh on an existing org/company SSO connection",
"label": "Refresh SCIM Token",
"name": "sso.connection.scim_token_refresh"
},
{
"description": "Details of a connection type change on an existing org/company SSO connection",
"label": "Change SSO Connection Type",
"name": "sso.connection.connection_type_change"
},
{
"description": "Details of a JIT toggle on an existing org/company SSO connection",
"label": "Toggle JIT provisioning",
"name": "sso.connection.jit_toggle"
}
],
"label": "Enterprise"
},
"offload": {
"actions": [
{
"description": "Details of the started Offload lease.",
"label": "Offload lease start",
"name": "lease.start"
},
{
"description": "Details of the ended Offload lease.",
"label": "Offload lease end",
"name": "lease.end"
}
],
"label": "Offload"
},
"oidc": {
"actions": [
{
"description": "Details of creating an OIDC connection.",
"label": "OIDC connection created",
"name": "connection.create"
},
{
"description": "Details of updating an OIDC connection.",
"label": "OIDC connection updated",
"name": "connection.update"
},
{
"description": "Details of deleting an OIDC connection.",
"label": "OIDC connection deleted",
"name": "connection.delete"
}
],
"label": "OIDC"
},
"org": {
"actions": [
{
"description": "Activities related to the creation of a new organization",
"label": "Organization Created",
"name": "create"
},
{
"description": "Details of the member added to your organization",
"label": "Organization Member Added",
"name": "member.add"
},
{
"description": "Details about the member removed from your organization",
"label": "Organization Member Removed",
"name": "member.remove"
},
{
"description": "Details about the role changed for a member in your organization",
"label": "Member Role Changed",
"name": "member.role.change"
},
{
"description": "Details of the member invited to your organization",
"label": "Org Member Invited",
"name": "member.invite.send"
},
{
"description": "Activities related to the creation of a team",
"label": "Organization Created",
"name": "team.create"
},
{
"description": "Activities related to the modification of a team",
"label": "Organization Deleted",
"name": "team.update"
},
{
"description": "Activities related to the deletion of a team",
"label": "Organization Deleted",
"name": "team.delete"
},
{
"description": "Details of the member added to your team",
"label": "Team Member Added",
"name": "team.member.add"
},
{
"description": "Details of the member removed from your team",
"label": "Team Member Removed",
"name": "team.member.remove"
},
{
"description": "Details of the single sign-on domain added to your organization",
"label": "Single Sign-On domain added",
"name": "domain.create"
},
{
"description": "Details of the single sign-on domain verified for your organization",
"label": "Single Sign-On domain verified",
"name": "domain.verify"
},
{
"description": "Details of the single sign-on domain removed from your organization",
"label": "Single Sign-On domain deleted",
"name": "domain.delete"
},
{
"description": "Details of toggling the Auto-Provisioning feature on a domain on or off",
"label": "Organization Auto-Provisioning Toggled",
"name": "domain.auto-provisioning.toggle"
},
{
"description": "Details related to the organization setting that was updated",
"label": "Organization Settings Updated",
"name": "settings.update"
},
{
"description": "Activities related to enabling Registry Access Management",
"label": "Registry Access Management enabled",
"name": "registry_access.enabled"
},
{
"description": "Activities related to disabling Registry Access Management",
"label": "Registry Access Management disabled",
"name": "registry_access.disabled"
},
{
"description": "Activities related to the addition of a registry",
"label": "Registry Access Management registry added",
"name": "registry_access.registry_added"
},
{
"description": "Details related to the registry that was updated",
"label": "Registry Access Management registry updated",
"name": "registry_access.registry_updated"
},
{
"description": "Activities related to the removal of a registry",
"label": "Registry Access Management registry removed",
"name": "registry_access.registry_removed"
},
{
"description": "Access token created in organization",
"label": "Access token created",
"name": "access_token.create"
},
{
"description": "Access token updated in organization",
"label": "Access token updated",
"name": "access_token.update"
},
{
"description": "Access token deleted in organization",
"label": "Access token deleted",
"name": "access_token.delete"
},
{
"description": "A custom role was created",
"label": "Custom role created",
"name": "customrole.create"
},
{
"description": "An existing custom role was updated",
"label": "Custom role updated",
"name": "customrole.update"
},
{
"description": "A custom role was deleted",
"label": "Custom role deleted",
"name": "customrole.delete"
},
{
"description": "A secure policy configuration was created",
"label": "Secure Policy Configuration created",
"name": "securepolicyconfigure.create"
},
{
"description": "A secure policy configuration was updated",
"label": "Secure Policy Configuration updated",
"name": "securepolicyconfigure.update"
},
{
"description": "A secure policy configuration was deleted",
"label": "Secure Policy Configuration deleted",
"name": "securepolicyconfigure.delete"
},
{
"description": "A secure policy client was created",
"label": "Secure Policy Client created",
"name": "securepolicyclient.create"
},
{
"description": "A secure policy client was updated",
"label": "Secure Policy Client updated",
"name": "securepolicyclient.update"
},
{
"description": "A secure policy client was deleted",
"label": "Secure Policy Client deleted",
"name": "securepolicyclient.delete"
},
{
"description": "A secure policy profile was created",
"label": "Secure Policy Profile created",
"name": "securepolicyprofile.create"
},
{
"description": "A secure policy profile was updated",
"label": "Secure Policy Profile updated",
"name": "securepolicyprofile.update"
},
{
"description": "A secure policy profile was deleted",
"label": "Secure Policy Profile deleted",
"name": "securepolicyprofile.delete"
}
],
"label": "Organization"
},
"repo": {
"actions": [
{
"description": "Activities related to the creation of a new repository",
"label": "Repository Created",
"name": "create"
},
{
"description": "Activities related to the modification of a repository",
"label": "Repository Updated",
"name": "update"
},
{
"description": "Activities related to the deletion of a repository",
"label": "Repository Deleted",
"name": "delete"
},
{
"description": "Details related to the privacy policies that were updated",
"label": "Privacy Changed",
"name": "change_privacy"
},
{
"description": "Details related to updating a repository categories",
"label": "Categories updated",
"name": "category.updated"
},
{
"description": "Details related to updating tag immutability of a repository",
"label": "Tag immutability updated",
"name": "immutable.tags.updated"
},
{
"description": "Activities related to the tags pushed",
"label": "Tag Pushed",
"name": "tag.push"
},
{
"description": "Activities related to the tags deleted",
"label": "Tag Deleted",
"name": "tag.delete"
}
],
"label": "Repository"
}
}
}
}
},
"schema": {
"$ref": "#/components/schemas/GetAuditActionsResponse"
}
}
},
"description": "A successful response."
},
"429": {
"content": {
"application/json": {
"examples": {
"response": {
"value": {
"detail": "Rate limit exceeded",
"error": false
}
}
},
"schema": {}
}
},
"description": ""
},
"500": {
"content": {
"application/json": {
"examples": {
"error": {
"summary": "Example error response",
"value": {
"errinfo": null,
"message": "internal error"
}
}
},
"schema": {
"$ref": "#/components/schemas/error"
}
}
},
"description": ""
},
"default": {
"content": {
"application/json": {
"examples": {
"error": {
"summary": "Example error response",
"value": {
"errinfo": null,
"message": "internal error"
}
}
},
"schema": {
"$ref": "#/components/schemas/error"
}
}
},
"description": "An unexpected error response."
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "List audit log actions",
"tags": [
"audit-logs"
]
}