Passo 2: crie uma organização

Neste passo, cria uma organização do Apigee.

Para criar uma nova organização e aprovisioná-la:

1. Na linha de comando, obtenha as suas credenciais de autenticação gcloud através do seguinte comando:

   Linux / MacOS

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

   Para verificar se o token foi preenchido, use echo, como mostra o exemplo seguinte:

   echo $TOKEN

   Esta ação deve apresentar o seu token como uma string codificada.

   Windows

   for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

   Para verificar se o token foi preenchido, use echo, como mostra o exemplo seguinte:

   echo %TOKEN%

   Esta ação deve apresentar o seu token como uma string codificada.

2. No passo 1, criou a variável de ambiente PROJECT_ID. Adicione estas variáveis de ambiente:

   Linux / MacOS

   export ORG_NAME=$PROJECT_ID
   export ANALYTICS_REGION="ANALYTICS_REGION"
   export RUNTIMETYPE=HYBRID

   Windows

   set ORG_NAME=$PROJECT_ID
   set ANALYTICS_REGION="ANALYTICS_REGION"
   set RUNTIMETYPE=HYBRID

   Onde:

   • ORG_NAME (Obrigatório): este valor tem de corresponder ao PROJECT_ID.
   • ANALYTICS_REGION (Obrigatório): a região principal para o armazenamento de dados de estatísticas, onde a variável está definida como uma das seguintes opções:

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

     Escolha uma região geograficamente próxima ou que satisfaça os requisitos de armazenamento da sua organização.

   • RUNTIMETYPE (Obrigatório): tem de estar definido como HYBRID.
3. Chame a seguinte API Apigee para criar a organização:

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

   Num pedido de criação bem-sucedido, a API Organizations responde com uma mensagem semelhante à seguinte:

   {
     "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"
     }
   }

   Onde:

   • LONG_RUNNING_OPERATION_ID é o UUID de uma operação assíncrona de longa duração. Pode usar este ID para verificar o estado do seu pedido de criação da organização (descrito no passo 5).
   • org_name é o ID da sua nova organização que está atualmente a ser criada.

   Como a propriedade state na resposta indica, o Apigee começou a criar a nova organização, pelo que o respetivo estado é IN_PROGRESS. Este processo pode demorar vários minutos.

   Se receber um erro, consulte o artigo Resolução de problemas de criação de organizações.

4. Guarde o ID da operação de longa duração numa variável de ambiente. Vai ser útil para tarefas de gestão futuras.

   Sintaxe

   export LONG_RUNNING_OPERATION_ID=LONG_RUNNING_OPERATION_ID

   Exemplo

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

5. Pode verificar o estado da operação de longa duração cujo ID foi devolvido pelo pedido de criação. Para o fazer, use a API Operations. Por exemplo:

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

   Os exemplos seguintes mostram possíveis respostas a este pedido:

   IN_PROGRESS

   Se o Apigee ainda estiver a criar a organização, o Apigee responde com o estado IN_PROGRESS. Por exemplo:

   {
     "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"
     }
   }

   Deve aguardar um pouco mais antes de tentar validar se o processo de criação está concluído.

   CONCLUÍDO

   Quando a organização tiver sido aprovisionada, o estado da operação de longa duração é FINISHED. Por exemplo:

   {
     "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",
       "description": "",
       "createdAt": "1626237148461",
       "lastModifiedAt": "1626237149384",
       "properties": {
         "property": [
           {
             "name": "features.hybrid.enabled",
             "value": "true"
           },
           {
             "name": "features.mart.connect.enabled",
             "value": "true"
           }
         ]
       },
       "analyticsRegion": "ANALYTICS_REGION",
       "runtimeType": "HYBRID",
       "subscriptionType": "TRIAL",
       "state": "ACTIVE",
       "billingType": "EVALUATION",
       "expiresAt": "1631421073171",
       "addonsConfig": {
         "advancedApiOpsConfig": {},
         "integrationConfig": {},
         "monetizationConfig": {}
       }
     }
   }

6. Pode usar a API de organizações do Apigee para obter informações sobre uma organização depois de esta ser criada. Por exemplo:

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

   A resposta ao seu pedido contém detalhes sobre a organização especificada no formato JSON.

   {
     "name": "apigee-example",
     "createdAt": "1626237148461",
     "lastModifiedAt": "1626237149384",
     "properties": {
       "property": [
         {
           "name": "features.hybrid.enabled",
           "value": "true"
         },
         {
           "name": "features.mart.connect.enabled",
           "value": "true"
         }
       ]
     },
     "analyticsRegion": "us-west1",
     "runtimeType": "HYBRID",
     "subscriptionType": "TRIAL",
     "projectId": "apigee-example",
     "state": "ACTIVE",
     "billingType": "EVALUATION",
     "expiresAt": "1631421073171",
     "addonsConfig": {
       "advancedApiOpsConfig": {},
       "integrationConfig": {},
       "monetizationConfig": {}
     }
   }

Resolução de problemas de criação da organização

Quando cria uma organização com a API Create organizations, pode receber uma resposta de erro. As respostas têm o seguinte aspeto:

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

A tabela seguinte apresenta os erros que pode receber e as potenciais resoluções quando tenta criar uma nova organização:

Passo seguinte

Aceda ao Passo 3: crie um grupo de ambientes.