Paso 4: Crea una organización

Has creado una cuenta y un proyecto de Google Cloud, y has habilitado las APIs. Ahora puedes crear tu organización.

Requisitos previos

Para crear una organización, debes cumplir una de las siguientes condiciones:

• Tener una cuenta de evaluación. Las cuentas de evaluación caducan a los 60 días. En ese momento, se eliminará la organización.
• Tener una cuenta de pago

Si no es así, debes ponerte en contacto con el equipo de ventas de Apigee para poder continuar.

Para crear una organización y aprovisionarla, sigue estos pasos:

1. En la línea de comandos, obtén tus credenciales de autenticación gcloud, como se muestra en el siguiente ejemplo:

   TOKEN=$(gcloud auth print-access-token)

   Para comprobar que el token se ha rellenado, usa echo, como se muestra en el siguiente ejemplo:

   echo $TOKEN

   Debería mostrar tu token como una cadena codificada.

   Para obtener más información, consulta la descripción general de la herramienta de línea de comandos gcloud.

2. Crea las siguientes variables de entorno para los elementos de la organización. Los usarás en el comando para crear la organización.
   • PROJECT_ID (obligatorio) es el proyecto de Google Cloud que quieres vincular a tu nueva organización habilitada para el modo híbrido. Es el ID que Google ha generado para ti en el paso 2: Crea un proyecto de Google Cloud.

     export PROJECT_ID=your_project_id

     

   • ORG_NAME (obligatorio) es el ID programático que quiere asignar a su organización con la función híbrida habilitada.

     export ORG_NAME=$PROJECT_ID

   • ORG_DISPLAY_NAME (Opcional) es el nombre fácil de usar de tu organización. Este valor no tiene por qué ser único y puede incluir espacios y caracteres especiales. Por ejemplo, "Mi organización híbrida".

     ORG_DISPLAY_NAME="friendly_name"

     El contenido de los nombres de las variables que contengan espacios debe incluirse entre comillas dobles. Por ejemplo, "Mi organización".

   • ORGANIZATION_DESCRIPTION (Opcional) es información sobre la organización que quieras usar como recordatorio de su propósito. Por ejemplo, "Mi primera organización".

     ORGANIZATION_DESCRIPTION="description_text"

   • ANALYTICS_REGION (Obligatorio) es la región principal para el almacenamiento de datos analíticos.

     export ANALYTICS_REGION=analytics_region

     El valor de analytics_region puede ser uno de los siguientes:

     asia-northeast1	asia-south1	asia-east1	asia-southeast1
     australia-southeast1	us-central1	us-east1	us-west1
     asia-southeast2	europe-west1	europe-west2

     Elige una región que esté cerca geográficamente o que cumpla los requisitos de almacenamiento de tu organización.

   • RUNTIMETYPE (Obligatorio) es el tipo de tiempo de ejecución de la organización de Apigee. HYBRID es el tiempo de ejecución de Apigee hybrid gestionado por el usuario.

     export RUNTIMETYPE=HYBRID

3. Envía una solicitud POST autenticada a la API Create organizations.

   En el siguiente ejemplo se muestra la estructura de la solicitud que crea una organización:

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
     -d '{
       "name":"'"$ORG_NAME"'",
       "displayName":"'"$ORG_DISPLAY_NAME"'",
       "description":"'"$ORGANIZATION_DESCRIPTION"'",
       "runtimeType":"'"$RUNTIMETYPE"'",
       "analyticsRegion":"'"$ANALYTICS_REGION"'"
     }' \
     "https://apigee.googleapis.com/v1/organizations?parent=projects/$PROJECT_ID"

   Si la solicitud de creación se realiza correctamente, la API de organizaciones debe responder con un mensaje similar al siguiente:

   {
     "name": "organizations/org_name/operations/long_running_operation_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "INSERT",
       "targetResourceName": "organizations/org_name",
       "state": "IN_PROGRESS"
     }
   }

   Donde:

   • long_running_operation_ID es el UUID de una operación asíncrona de larga duración. Puedes usar este ID para comprobar el estado de tu solicitud de creación de organización (descrita en el paso 5).
   • org_name es el ID de la nueva organización que se está creando.

   Como indica la propiedad state de la respuesta, Apigee ha empezado a crear la nueva organización, por lo que su estado es IN_PROGRESS. Este proceso puede tardar varios minutos.

   Si aparece un error, consulta Solucionar problemas al crear una organización.

4. Guarda el ID de la operación de larga duración en una variable de entorno. Te será útil para futuras tareas de gestión.

   Sintaxis

   export LONG_RUNNING_OPERATION_ID=long_running_operation_ID

   Ejemplo

   export LONG_RUNNING_OPERATION_ID=6abc8a72-46de-f9da-bcfe-70d9ab347e4f

5. Puedes consultar el estado de la operación de larga duración cuyo ID devolvió Apigee en tu solicitud de creación inicial. Para ello, usa la API Operations. Por ejemplo:

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/operations/$LONG_RUNNING_OPERATION_ID"

   En los siguientes ejemplos se muestran posibles respuestas a esta solicitud:

   IN_PROGRESS

   Si Apigee sigue creando la organización, responde con el estado IN_PROGRESS. Por ejemplo:

   {
       "name": "organizations/org_name/operations/long_running_operation_ID",
       "metadata": {
         "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
         "operationType": "INSERT",
         "targetResourceName": "organizations/org_name",
         "state": "IN_PROGRESS"
       }
     }

   Deberías esperar un poco más antes de intentar verificar que el proceso de creación se ha completado.

   TERMINADO

   Cuando se haya aprovisionado la organización, el estado de la operación de larga duración será FINISHED. Por ejemplo:

   {
     "name": "organizations/org_name/operations/long_running_operation_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "INSERT",
       "targetResourceName": "organizations/org_name",
       "state": "FINISHED"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.Organization",
       "name": "org_name",
       "displayName": "display_name",
       "description": "description",
       "createdAt": "1600817805771",
       "lastModifiedAt": "1600817805771",
       "properties": {
         "property": [
           {
             "name": "features.hybrid.enabled",
             "value": "true"
           },
           {
             "name": "features.mart.connect.enabled",
             "value": "true"
           }
         ]
       },
       "analyticsRegion": "us-central1",
       "runtimeType": "HYBRID",
       "subscriptionType": "TRIAL"
     }
   }

   Si no has introducido una descripción, ese campo no aparecerá en la respuesta.

Ver los detalles de la organización

Puede ver los detalles de los metadatos de la organización que ha creado mediante una API de Apigee. También puedes usar una API para enumerar todas las organizaciones a las que tiene acceso tu cuenta de Google Cloud. Para llevar a cabo estas acciones, debes usar la API Organizations.

Antes de probar las APIs, actualiza tu token de autorización:

TOKEN=$(gcloud auth print-access-token)

https://apigee.googleapis.com/v1/organizations/org_name

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/hybrid-example"

{
  "name": "organizations/org_name/operations/long_running_operation_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "org_name",
    "state": "FINISHED"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.Organization",
    "name": "org_name",
    "displayName": "display_name",
    "description": "description",
    "createdAt": "1600817805771",
    "lastModifiedAt": "1600817805771",
    "properties": {
      "property": [
        {
          "name": "features.hybrid.enabled",
          "value": "true"
        },
        {
          "name": "features.mart.connect.enabled",
          "value": "true"
        }
      ]
    },
    "analyticsRegion": "us-central1",
    "runtimeType": "HYBRID",
    "subscriptionType": "TRIAL"
  }
}

https://apigee.googleapis.com/v1/organizations

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations"

{
  "organizations": [
    {
      "organization": "hybrid-example",
      "projectIds": [
        "hybrid-example"
      ]
    }
  ]
}

Solucionar problemas de creación de organizaciones

Cuando creas una organización con la API Create organizations, es posible que recibas una respuesta de error. Las respuestas tienen este aspecto:

{
  "error": {
    "code": HTTP_error_code,
    "message": "short_error_message",
    "status": "high_level_error_type",
    "details": [
      {
        "@type": "specific_error_type",
        "detail": "expanded_error_description"
      }
    ]
  }
}

En el siguiente ejemplo se muestra una respuesta a un error habitual: el ID de organización contiene caracteres no válidos (no se permiten caracteres en mayúsculas en los IDs de organización):

{
  "error": {
    "code": 400,
    "message": "invalid Organization ID \"MY-ORG\": \"MY-ORG\" is an invalid Organization ID",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "",
        "detail": "[ORIGINAL ERROR] generic::invalid_argument: invalid Organization ID \"MY-ORG\":
          \"My-ORG\" is an invalid Organization ID [google.rpc.error_details_ext]
          { message: \"invalid Organization ID \\\"MY-ORG\\\": \\\"MY-ORG\\\" is an invalid
          Organization ID\" }"
      }
    ]
  }
}

En ese caso, puedes cambiar el nombre de la organización a letras minúsculas y volver a enviar tu solicitud.

En la siguiente tabla se muestran los errores que puedes recibir y las posibles soluciones cuando intentas crear una organización: