删除报告

通过 App Optimize API 创建的报告会在创建 24 小时后自动删除。不过,如果您不再需要报告,可以使用 API 在报告预定的过期时间之前明确将其删除。

删除后,您将无法再通过 App Optimize API 访问相应报告及其数据。

准备工作

gcloud

  • 安装 Google Cloud CLI。

  • 配置 gcloud CLI 以使用您的联合身份。

    如需了解详情,请参阅使用联合身份登录 gcloud CLI。

  • 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  • 初始化 gcloud CLI 后,对其进行更新并安装所需组件:

    gcloud components update
    gcloud components install beta
  • 如需了解如何为生产环境设置身份验证,请参阅 Google Cloud 身份验证文档中的 为在 Google Cloud上运行的代码设置应用默认凭据 。

    Python

    1. 安装 App Optimize API 的 Python 客户端库。
    2. 如需在本地开发环境中使用本页面上的 Python 示例,请安装并初始化 gcloud CLI,然后使用您的用户凭据设置应用默认凭据。

      1. 安装 Google Cloud CLI。

      2. 配置 gcloud CLI 以使用您的联合身份。

        如需了解详情,请参阅使用联合身份登录 gcloud CLI。

      3. 为您的用户账号创建本地身份验证凭证:

        gcloud auth application-default login

        如果系统返回身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI。

      如需了解详情,请参阅 Google Cloud 身份验证文档中的 为本地开发环境设置 ADC。

      如需了解如何为生产环境设置身份验证,请参阅 Google Cloud 身份验证文档中的 为在 Google Cloud上运行的代码设置应用默认凭据 。

    REST

    如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。

      安装 Google Cloud CLI,然后 使用联合身份登录 gcloud CLI。

    如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

    如需了解如何为生产环境设置身份验证,请参阅 Google Cloud 身份验证文档中的 为在 Google Cloud上运行的代码设置应用默认凭据 。

    所需的角色

    如需获得删除报告所需的权限,请让您的管理员向您授予拥有报告资源的项目的 App Optimize Admin (roles/appoptimize.admin) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

    删除报告

    如需删除报告,请按照您偏好的方法对应的说明操作:

    gcloud

    使用 gcloud beta app-optimize reports delete 命令可移除您的报告。

    gcloud beta app-optimize reports delete REPORT_ID \
      --project=PROJECT_ID \
      --location=global
    

    替换以下内容:

    • PROJECT_ID:您要删除的报告资源所属的 Google Cloud 项目的 ID。
    • REPORT_ID:要删除的报告的 ID。 此 ID 是在创建报告时指定的,可以通过列出项目中的报告来获取。

    Python

    以下 Python 代码使用 AppOptimizeClient.delete_report() 移除您的报告。

    from google.cloud import appoptimize_v1beta
    
    project_id = "PROJECT_ID"
    report_id = "REPORT_ID"
    name = f"projects/{project_id}/locations/global/reports/{report_id}"
    
    # Create the App Optimize client and request a report deletion
    client = appoptimize_v1beta.AppOptimizeClient()
    request = appoptimize_v1beta.DeleteReportRequest(name=name)
    client.delete_report(request=request)
    print(f"Deleted report: {name}")
    

    替换以下内容:

    • PROJECT_ID:您要删除的报告资源所属的 Google Cloud 项目的 ID。
    • REPORT_ID:要删除的报告的 ID。 此 ID 是在创建报告时指定的,可以通过列出项目中的报告来获取。

    REST

    使用以下 curl 命令向报告的资源端点发送 HTTP DELETE 请求:

    curl -X DELETE \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports/REPORT_ID"
    

    替换以下内容:

    • PROJECT_ID:您要删除的报告资源所属的 Google Cloud 项目的 ID。
    • REPORT_ID:要删除的报告的 ID。 此 ID 是在创建报告时指定的,可以通过列出项目中的报告来获取。

    如果请求成功,API 会返回空的 JSON 响应 {}。

    后续步骤