amp event-properties
このページはまだあなたの言語に翻訳されていません。 現在取り組んでいますので、後でもう一度確認してください。
amp event-properties manages the properties associated with an event. Read commands require taxonomy:read; create, update, and delete require taxonomy:write.
amp event-properties list
Returns properties bound to a specific event, including ingested-only properties (those with is_in_schema: false). Use the is_in_schema flag to detect whether a PATCH will succeed before issuing it.
amp event-properties list --project <project_id> --event <event_type> --limit 5
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--event | string | Yes | Public event identifier. This value is the event type name (the string used when sending the event to Amplitude). Alias: --event-id, --event-type. |
--cursor | string | No | Opaque cursor from pagination.next_cursor on the previous response. Numeric offsets are capped by the underlying search index (10,000 results per query). Well-formed pagination stops before that window; requests whose cursor would exceed it return 400 pagination_not_supported. Alias: --next-cursor. |
--limit | integer | No | Number of items to return. Defaults to 50, max 200. |
--q | string | No | Full-text search query. Alias: --query. |
Requires the taxonomy:read scope.
amp event-properties get
Get event property.
amp event-properties get --project <project_id> --event <event_type> --property <property_name>
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--event | string | Yes | Public event identifier. This value is the event type name (the string used when sending the event to Amplitude). Alias: --event-id, --event-type. |
--property | string | Yes | Public event property identifier. Equal to property_name. URL-encode when the property name contains spaces or special characters. Alias: --property-name, --name. |
Requires the taxonomy:read scope.
amp event-properties create
Creates an event property and adds it to the project's tracking plan (is_in_schema: true after success). If the property already exists in the schema, the existing resource is returned without modification. If the property exists ingested-only (is_in_schema: false), this call promotes it into the schema with the metadata supplied here.
amp event-properties create --project <project_id> --event <event_type> --property <property_name> --data-type string
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--event | string | Yes | Public event identifier. This value is the event type name (the string used when sending the event to Amplitude). Alias: --event-id, --event-type. |
--idempotency-key | string | No | Generated automatically when omitted. Header acceptance alone does not guarantee retry deduplication. |
--property | string | Yes | Alias: --property-name, --name. |
--description | string | No | |
--data-type | string: string, number, boolean, object, enum, any | No | Logical data type of a property. null means untyped at the source; clients should treat it as string for ingestion. Alias: --type. |
--is-array | boolean | No | |
--enum-values | array | No | JSON array, or a comma-separated list for strings. |
--regex | string | No | |
--is-hidden | boolean | No | |
--classifications | array | No | JSON array, or a comma-separated list for strings. |
Requires the taxonomy:write scope.
amp event-properties update
Updates metadata on an event property. Returns 422 not_in_schema if the property is ingested-only (is_in_schema: false); promote it via POST first. Field absent means leave unchanged; field with null clears (where allowed). enum_values and classifications replace the array entirely — there is no per-item add/remove.
amp event-properties update --project <project_id> --event <event_type> --property <property_name> --description "Updated description"
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--event | string | Yes | Public event identifier. This value is the event type name (the string used when sending the event to Amplitude). Alias: --event-id, --event-type. |
--property | string | Yes | Public event property identifier. Equal to property_name. URL-encode when the property name contains spaces or special characters. Alias: --property-name, --name. |
--idempotency-key | string | No | Generated automatically when omitted. Header acceptance alone does not guarantee retry deduplication. |
--description | string | No | |
--data-type | string: string, number, boolean, object, enum, any | No | Logical data type of a property. null means untyped at the source; clients should treat it as string for ingestion. Alias: --type. |
--is-array | boolean | No | |
--enum-values | array | No | JSON array, or a comma-separated list for strings. |
--regex | string | No | |
--is-hidden | boolean | No | |
--classifications | array | No | JSON array, or a comma-separated list for strings. |
Requires the taxonomy:write scope.
amp event-properties delete
Deletes an event property. Preview the deletion with --dry-run. At a terminal, the command asks for confirmation; pass --yes to skip the prompt.
amp event-properties delete --project <project_id> --event <event_type> --property <property_name> --dry-run
amp event-properties delete --project <project_id> --event <event_type> --property <property_name> --yes
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--event | string | Yes | Public event identifier. This value is the event type name (the string used when sending the event to Amplitude). Alias: --event-id, --event-type. |
--property | string | Yes | Public event property identifier. Equal to property_name. URL-encode when the property name contains spaces or special characters. Alias: --property-name, --name. |
--dry-run | boolean | No | Validate request without performing mutation. |
--idempotency-key | string | No | Generated automatically when omitted. Header acceptance alone does not guarantee retry deduplication. |
Requires the taxonomy:write scope.
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.