Ressourcen verwalten und löschen

Auf dieser Seite wird erklärt, wie Config Connector eine vorhandene Ressource verwaltet und Ressourcen löscht.

Wenn Sie eine Ressource mit Config Connector definieren, geschieht eine der folgenden Aktionen:

  • Wenn die Ressource nicht vorhanden ist, erstellt Config Connector sie. Ein Beispiel für das Erstellen einer neuen Ressource finden Sie unter Erste Schritte mit Config Connector.
  • Wenn eine Ressource mit demselben Namen bereits vorhanden ist, ruft Config Connector diese Ressource ab und beginnt mit der Verwaltung. Config Connector sucht nach dem Namen in der Organisation, im Projekt oder im Ordner. Auf dieser Seite wird ausführlich erklärt, wie Config Connector Ressourcen abruft, verwaltet und löscht.

Alternativ können Sie Ressourcen mit dem Feld resourceID verwalten. Einige Ressourcen können nur mit dem Feld resourceID abgerufen werden. Einige Ressourcen können nur als neue Ressourcen erstellt und nicht abgerufen werden. Weitere Informationen finden Sie unter Ressourcen mit dem resourceID Feld verwalten.

Eine vorhandene Ressource abrufen

In diesem Abschnitt wird beschrieben, wie Sie eine vorhandene Ressource mit Config Connector abrufen. Als Beispiel wird eine BigQuery-Ressource verwendet.

Hinweis

  1. "BigQuery API aktivieren".
  2. Prüfen Sie, ob Sie Zugriff auf das bq Befehlszeilentool haben. Wenn Sie bq nicht haben, verwenden Sie Cloud Shell oder installieren Sie es mit der gcloud CLI.

BigQuery-Dataset erfassen

Config Connector erwirbt oder übernimmt die Kontrolle über Ressourcen, wenn die Werte im Manifest und der Ressourcenname übereinstimmen. Wenn eine Ressource keinen Namen hat (z. B. eine Projekt-ID), wird die ID der Ressource verwendet.

Durch Erstellen eines leeren BigQuery-Datasets und anschließendem Abruf dieses Datasets durch Config Connector erfahren Sie, wie Config Connector vorhandene Ressourcen verarbeitet.

  1. Erstellen Sie mit bq ein BigQuery-Dataset mit dem Namen bigquerydatasetsample:

    bq --location=US mk \
--dataset \
--default_table_expiration 3600 \
--description description \
PROJECT_ID:bigquerydatasetsample

  2. Kopieren Sie den folgenden Inhalt in eine Datei namens bq-sample.yaml:

      apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
  kind: BigQueryDataset
  metadata:
    name: bigquerydatasetsample
  spec:
    defaultTableExpirationMs: 3600000
    description: "BigQuery Dataset Sample"
    friendlyName: bigquerydataset-sample
    location: US

  3. Wenden Sie die YAML auf Ihren Cluster an.

    kubectl apply --namespace CC_NAMESPACE -f bq-sample.yaml

    Ersetzen Sie dabei CC_NAMESPACE durch den Namespace, von dem aus Config Connector Ressourcen verwaltet.

  4. Verwenden Sie kubectl describe, um Details zum Dataset anzuzeigen.

    kubectl describe --namespace CC_NAMESPACE bigquerydataset bigquerydatasetsample

    Ersetzen Sie dabei CC_NAMESPACE durch den Namespace, von dem aus Config Connector Ressourcen verwaltet.

    Die Ausgabe von kubectl describe enthält Metadaten zum Status und dem Inhaber der Ressource.

Dataset löschen

Standardmäßig wird, wenn eine Ressource von Config Connector abgerufen und verwaltet wird, diese Ressource durch Löschen des Objekts aus dem Cluster ebenfalls gelöscht. Wenn Sie das Dataset beibehalten möchten, legen Sie die deletion-policy der Ressource fest.

Beispielsweise wird durch Löschen des Manifests, das bigquerydataset-sample abgerufen hat, auch das Dataset aus BigQuery gelöscht.

  1. Sie können das Dataset bigquerydataset-sample mit kubectl delete löschen:

    kubectl delete --namespace CC_NAMESPACE -f bq-sample.yaml

    Ersetzen Sie dabei CC_NAMESPACE durch den Namespace, von dem aus Config Connector Ressourcen verwaltet.

    Die Ausgabe von kubectl bestätigt das Löschen:

    bigquerydataset.bigquery.cnrm.cloud.google.com "bigquerydatasetsample" deleted

  2. Prüfen Sie mit bq, ob das Dataset wirklich nicht mehr vorhanden ist:

    bq show PROJECT_ID:bigquerydatasetsample

    Die Ausgabe dieses Befehls enthält die Angabe Not Found.

Ressourcen nach dem Löschen beibehalten

...
metadata:
  annotations:
    cnrm.cloud.google.com/deletion-policy: abandon
...

Das folgende beispielhafte YAML-Manifest für das oben beschriebene BigQuery-Dataset enthält die Richtlinie zur Datenlöschung abandon:

apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
kind: BigQueryDataset
metadata:
  name: bigquerydatasetsample
  annotations:
    cnrm.cloud.google.com/deletion-policy: abandon
spec:
  defaultTableExpirationMs: 3600000
  description: "BigQuery Dataset Sample"
  friendlyName: bigquerydataset-sample
  location: US

Ressourcen mit Einschränkungen in Bezug auf die Akquisition

Einige Ressourcen können nicht gemäß der Anleitung im vorherigen Abschnitt abgerufen werden. In diesem Abschnitt werden die Einschränkungen in Bezug auf die Akquisition für einige Ressourcen beschrieben.

Ressourcen mit einer dienstgenerierten Ressourcen-ID

Sie können Ressourcen, die eine dienstgenerierte Ressourcen ID haben, nur über das Feld resourceID abrufen. Google Cloud

Folgende Config Connector-Ressourcen entsprechen Google Cloud Ressourcen, die dienstgenerierte Ressourcen-IDs haben:

  • AccessContextManagerAccessPolicy
  • ApigeeOrganization
  • BigQueryDataTransferConfig
  • BillingBudgetsBudget
  • CloudIdentityGroup
  • CloudIdentityMembership
  • ComputeFirewallPolicy
  • DLPDeidentifyTemplate
  • DLPInspectTemplate
  • DLPJobTrigger
  • DLPStoredInfoType
  • DataCatalogPolicyTag
  • DataCatalogTaxonomy
  • EssentialContactsContact
  • Folder
  • IAPBrand
  • IAPIdentityAwareProxyClient
  • IdentityPlatformTenant
  • MonitoringAlertPolicy
  • MonitoringGroup
  • MonitoringNotificationChannel
  • MonitoringUptimeCheckConfig
  • RecaptchaEnterpriseKey
  • ResourceManagerLien
  • SQLSSLCert
  • SecretManagerSecretVersion
  • StorageNotification
  • StorageTransferJob
  • TagsTagBinding
  • TagsTagKey
  • TagsTagValue
  • VertexAIDataset
  • VertexAIIndex

Weitere Informationen zur Verwendung des Felds resourceID finden Sie unter Ressourcen mit dem Feld „resourceID“ verwalten.

Ressourcen, die nicht übernommen werden können

Folgende Config Connector-Ressourcen unterstützen die Übernahme vorhandener Ressourcen Google Cloud nicht:

  • DataflowFlexTemplateJob
  • FirestoreIndex
  • IAMServiceAccountKey

Nächste Schritte