For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/snowflake-integration/create-a-snowflake-integration-account.md. A documentation index is available at /llms.txt.
Language
Datadog site

Create a Snowflake integration account

WARNINGNote: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.
POSThttps://api.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.us3.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.us5.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.datadoghq.eu/api/v2/integration-interfaces/snowflake/accountshttps://api.ap1.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.ap2.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.uk1.datadoghq.com/api/v2/integration-interfaces/snowflake/accountshttps://api.ddog-gov.com/api/v2/integration-interfaces/snowflake/accountshttps://api.us2.ddog-gov.com/api/v2/integration-interfaces/snowflake/accounts

Présentation

Create a Snowflake integration account.

This endpoint requires the manage_integrations permission.

Requête

Body Data (required)

Champ
Type
Description
data [required]
object

Data envelope for creating a Snowflake integration account.

Réponse

Created

Response payload for a single Snowflake integration account.

Champ
Type
Description
data [required]
object

Data envelope of a Snowflake integration account, including server-assigned identity.

Exemple de code

Create a Snowflake integration account
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration-interfaces/snowflake/accounts" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "snowflake_private_key",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
        "private_key_name": "my-rsa-key",
        "private_key_passphrase": "your-private-key-passphrase"
      },
      "dataflows": {
        "snowflake-account-usage-metrics": {
          "enabled": true,
          "settings": {
            "account_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-cloud-cost-metrics": {
          "enabled": true,
          "settings": {
            "query_tags": "env,team,cost_center"
          }
        },
        "snowflake-data-observability-quality-monitoring": {
          "enabled": true,
          "settings": {
            "do_table_crawler_cron": "0 */6 * * *",
            "sync_snowflake_system_database": true
          }
        },
        "snowflake-event-table-logs": {
          "enabled": true,
          "settings": {
            "event_table_events_enabled": true,
            "event_table_logs_enabled": true,
            "event_table_logs_interval_min": 15,
            "event_table_span_events_enabled": false,
            "event_table_spans_enabled": false
          }
        },
        "snowflake-organization-usage-metrics": {
          "enabled": true,
          "settings": {
            "organization_usage_metrics_aggregate_last_24h": false
          }
        },
        "snowflake-query-history-logs": {
          "enabled": true,
          "settings": {
            "join_query_history_with_access_history_enabled": true,
            "query_history_logs_interval_min": 15
          }
        },
        "snowflake-security-logs": {
          "enabled": true,
          "settings": {
            "security_logs_interval_min": 60
          }
        },
        "snowflake-task-history-logs": {
          "enabled": true,
          "settings": {
            "task_history_logs_interval_min": 30
          }
        }
      },
      "name": "prod-snowflake",
      "settings": {
        "snowflake_account_identifier": "myorg-myaccount",
        "username": "datadog_user"
      }
    },
    "type": "integration-account"
  }
}
EOF