Borra una organización de Apigee

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En esta página, se explica cómo borrar por completo una organización de Apigee de un proyecto de Google Cloud, incluidos los pasos de seguimiento necesarios para liberar los recursos de red que Apigee no limpia por sí solo. La limpieza posterior a la eliminación que debes realizar depende de cómo se aprovisionó la organización:

  • Las organizaciones aprovisionadas con el intercambio de tráfico entre VPC habilitado también tienen una conexión de intercambio de tráfico entre VPC de Service Networking entre tu VPC y la red de usuarios de Apigee. Esa conexión y cualquier rango de intercambio de tráfico reservado y red de VPC asociada a ella permanecen en su lugar después de borrar la organización y se deben limpiar por separado si ya no los necesitas. Consulta Seguimiento: Organizaciones aprovisionadas con intercambio de tráfico entre VPC.

  • Las organizaciones aprovisionadas con el intercambio de tráfico entre VPC inhabilitado usan Private Service Connect en lugar de una conexión de Service Networking, por lo que no hay intercambio de tráfico de productor para quitar. Aún debes borrar el balanceador de cargas de Private Service Connect en dirección norte que creaste cuando aprovisionaste la organización: la regla de reenvío, el proxy HTTPS de destino, el mapa de URLs, el servicio de backend, el grupo de extremos de red de PSC, el certificado SSL y la dirección IP reservada, o la regla de reenvío y la dirección IP reservada seguirán generando cargos. Consulta Seguimiento: Organizaciones aprovisionadas sin intercambio de tráfico de VPC.

En Antes de comenzar, se muestra cómo determinar en qué categoría se encuentra tu organización.

Antes de comenzar

Permisos de IAM obligatorios

  • En la organización de Apigee (por lo general, APIGEE_PROJECT_ID): apigee.organizations.delete. Este permiso se incluye en el rol roles/apigee.admin, que la guía de roles de Apigee describe como el único rol que puede crear, borrar o actualizar organizaciones.

  • Además, si tu organización se aprovisionó con el intercambio de tráfico entre VPC habilitado y planeas limpiar la conexión de Service Networking, el rango de intercambio de tráfico entre VPC o la red de VPC como se describe en Seguimiento: organizaciones aprovisionadas con intercambio de tráfico entre VPC: en el proyecto que posee la red de VPC con intercambio de tráfico (el proyecto de red, que puede diferir de tu proyecto de Apigee en una configuración de VPC compartida), servicenetworking.services.deleteConnection, compute.globalAddresses.delete y compute.networks.delete.

Borra primero los recursos dependientes

Antes de borrar la organización, borra los recursos que Apigee te exige que quites primero:

Crea una copia de seguridad de los datos que quieras conservar

Crea una copia de seguridad de los datos o recursos con alcance de organización que puedas necesitar más adelante. Una vez que transcurre el período de retención, los datos almacenados en la organización no se pueden recuperar.

Determina si tu organización usa el intercambio de tráfico entre VPC

La limpieza de seguimiento que debes realizar después de borrar la organización depende de si la organización se aprovisionó con el intercambio de tráfico entre VPC habilitado. Lee la configuración de la organización con la API organizations.get antes de borrarla: 

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Esta y todas las demás llamadas de REST de Apigee en esta página se dirigen al extremo global apigee.googleapis.com. Si tu organización se encuentra en una región de residencia de datos, sustituye el extremo regional correspondiente en cada muestra.

Busca el campo disableVpcPeering en la respuesta:

  • Si la respuesta contiene "disableVpcPeering": true, la organización se aprovisionó sin intercambio de tráfico de VPC. Después de borrar la organización, sigue los pasos que se indican en Seguimiento: organizaciones aprovisionadas sin intercambio de tráfico de VPC.

  • Si el campo es false o está ausente, la organización se aprovisionó con el intercambio de tráfico entre VPC. Registra los siguientes dos valores adicionales de la misma respuesta, ya que los necesitarás durante la limpieza:

    • El campo authorizedNetwork, que identifica la red de VPC que intercambia tráfico con Apigee. Aparece en una de estas dos formas:
      • Una ruta de acceso completa del recurso projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, que codifica el proyecto de red y el nombre de la red. Este formato se usa cuando la red reside en un proyecto diferente del de tu organización de Apigee, con mayor frecuencia en una configuración de VPC compartida, en la que la red está en el proyecto host.
      • Solo un nombre de red (por ejemplo, apigee-network). Cuando solo está presente el nombre, la red se encuentra en el mismo proyecto de Google Cloud que tu organización de Apigee. Trata ese proyecto (APIGEE_PROJECT_ID) como NETWORK_PROJECT_ID para los pasos de limpieza.
      Ten en cuenta que authorizedNetwork solo se establece en las organizaciones con intercambio de tráfico entre VPC.
    • Es el nombre de la dirección global que reservaste originalmente para el rango de intercambio de tráfico entre VPC (por ejemplo, apigee-range). Reservaste esta dirección cuando aprovisionaste la organización por primera vez.

    Después de borrar la organización, sigue Seguimiento: organizaciones aprovisionadas con intercambio de tráfico entre VPC.

Borra la organización de Apigee

Llama a la API organizations.delete para borrar la organización. La llamada devuelve una operación de larga duración y, en el caso de las organizaciones de evaluación, realiza una eliminación inmediata; en el caso de las organizaciones pagadas (suscripción o pago por uso), realiza una eliminación no definitiva sujeta al período de retención. 

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Para usar el período de retención mínimo (24 horas) para una organización pagada, agrega el parámetro de consulta retention: 

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION?retention=MINIMUM"

La respuesta contiene una operación de larga duración. Puedes sondearla con organizations.operations.get.

Seguimiento: Organizaciones aprovisionadas sin intercambio de tráfico entre VPC

Si el campo disableVpcPeering de la organización es true, borrar la organización no libera recursos de redes de servicios, ya que una organización aprovisionada sin intercambio de tráfico de VPC nunca tuvo una conexión de redes de servicios y no hay intercambio de tráfico de productor para quitar.

Aún debes borrar el balanceador de cargas de Private Service Connect en dirección norte que creaste en tu propio proyecto cuando aprovisionaste la organización. Estos recursos no son propiedad de Apigee, y organizations.delete no lanza ninguno de ellos. Bórralos en orden inverso de dependencia:

  1. Regla de reenvío
  2. Proxy HTTPS de destino
  3. Mapa de URL
  4. Servicio de backend
  5. Grupo de extremos de red de PSC
  6. Certificado SSL
  7. Dirección IP reservada

Cuando se complete la limpieza de la conexión norte, continúa con Período de retención y reaprovisionamiento.

Seguimiento: Organizaciones aprovisionadas con intercambio de tráfico entre VPC

Borrar la organización de Apigee no libera la conexión de intercambio de tráfico de VPC de Service Networking que estableciste cuando se aprovisionó la organización. La conexión permanece en tu red de VPC, junto con el rango de intercambio de tráfico reservado y cualquier red de VPC que hayas dedicado al intercambio de tráfico. Si ya no necesitas estos recursos, completa la limpieza siguiendo los procedimientos canónicos de Configura el acceso privado a servicios y Herramientas de redes de servicios. En el resto de esta sección, solo se proporcionan los valores y las advertencias específicos de una eliminación de Apigee.

Recopila los valores que necesitas

En los siguientes pasos de limpieza, se reutilizan los mismos valores para conectarlos a los procedimientos de las guías vinculadas de redes de servicios y VPC. Determina cada valor una vez y, luego, configúralo como una variable de shell para que puedas copiar los comandos vinculados de forma literal:

  • NETWORK_PROJECT_ID: Es el proyecto propietario de la red de VPC con intercambio de tráfico. No siempre es el mismo que tu proyecto de servicio de Apigee: en una configuración de VPC compartida, la red reside en el proyecto host. Derívalo del valor de authorizedNetwork que registraste en Determina si tu organización usa el intercambio de tráfico entre VPC:

    • Si authorizedNetwork es una ruta de acceso completa del recurso projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, toma NETWORK_PROJECT_ID de esa ruta de acceso.
    • Si authorizedNetwork es solo un nombre de red (por ejemplo, apigee-network), la red se encuentra en el mismo proyecto que la organización de Apigee. Usa tu proyecto de Apigee (APIGEE_PROJECT_ID).

  • NETWORK_NAME: Es el nombre de la red de VPC (por ejemplo, apigee-network). Tómalo de la ruta de acceso completa en authorizedNetwork o usa el valor sin formato cuando authorizedNetwork sea solo un nombre.

  • APIGEE_RANGE_NAME: Es el nombre de la dirección global que se asignó para el rango de intercambio de tráfico de VPC (por ejemplo, apigee-range) cuando se aprovisionó la organización. Puedes ver los rangos reservados adjuntos al intercambio de tráfico en la lista reservedPeeringRanges que devuelve gcloud services vpc-peerings list.

  • NETWORK_PROJECT_NUMBER: Es el número de proyecto numérico de NETWORK_PROJECT_ID. La API de REST de Service Networking requiere el número de proyecto (no el ID del proyecto) en el campo consumerNetwork:

    gcloud projects describe NETWORK_PROJECT_ID \
  --format="value(projectNumber)"

Cada vez que un procedimiento vinculado solicite una red, un proyecto de red o una red de consumidor, sustituye estos valores.

Advertencias que se aplican a una eliminación de Apigee

Completa la limpieza

Sigue los procedimientos vinculados y sustituye las variables de Recopila los valores que necesitas:

  • Borra la conexión de redes de servicios. Sigue las instrucciones para borrar una conexión privada. Como ya borraste la organización de Apigee en Borra la organización de Apigee, se cumple el requisito previo de la guía de quitar la instancia de servicio para las organizaciones de evaluación, que se borran de inmediato. En el caso de las organizaciones pagadas, la eliminación es no definitiva y se realiza correctamente solo una vez que transcurre el período de retención. Consulta Período de retención y reaprovisionamiento o borra la organización con ?retention=MINIMUM para acortar el período a 24 horas. Cuando el procedimiento solicite la red y el proyecto de red, usa NETWORK_NAME y NETWORK_PROJECT_ID. Cuando la llamada de REST services.connections.deleteConnection subyacente solicite consumerNetwork, usa projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME.

  • Libera el rango de intercambio de tráfico reservado (opcional). Sigue Borra un rango de direcciones IP asignado con APIGEE_RANGE_NAME y NETWORK_PROJECT_ID. El rango reservado es un recurso que pertenece al cliente y que persiste después de que se borran la organización de Apigee y la conexión de redes de servicios. Dejarlo en su lugar no interrumpe ningún servicio de Google Cloud.

  • Borra la red de VPC (opcional). Si enrutaste el tráfico hacia el norte a través de un grupo de instancias administrado o un balanceador de cargas interno en esta red, borra esos recursos primero; de lo contrario, la eliminación de la red fallará con un error de recurso dependiente: regla de reenvío, proxy de destino, mapa de URL, servicio de backend, grupo de instancias administrado, plantilla de instancias, verificación de estado, reglas de firewall y dirección reservada. Luego, sigue las instrucciones para borrar una red en la guía de redes de VPC, con NETWORK_NAME y NETWORK_PROJECT_ID.

Período de retención y reaprovisionamiento

Como se documenta en la referencia de organizations.delete, se aplica lo siguiente:

  • Apigee borra las organizaciones de evaluación de inmediato.
  • Apigee borra de forma no definitiva las organizaciones pagadas (de suscripción o pago por uso) con un período de retención predeterminado de 7 días. Durante el período de retención, puedes restablecer la organización enviando un ticket de asistencia a Apigee. Pasar ?retention=MINIMUM en la solicitud de eliminación acorta la ventana a 24 horas.
  • No puedes volver a crear una organización de Apigee en el mismo proyecto de Google Cloud durante el período de retención.

¿Qué sigue?

Referencias de Apigee:

Referencias de Service Networking y acceso privado a servicios: