Проверьте статус и настройки интеграции

Вы просматриваете документацию Apigee Edge .
Перейти к документации Apigee X. info

На этой странице описывается, как проверить состояние и настройки интеграции коннектора API Apigee Edge в вашей организации Apigee Edge после его включения.

Проверка настроек интеграции коннектора API-концентратора

Чтобы получить настройки интеграции коннектора API-центра для организации, выполните GET-запрос, чтобы отправить следующий запрос:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/settings -H "Authorization: Bearer OAUTH_TOKEN"

Где:

• ORG_NAME — название вашей организации Apigee Edge.
• OAUTH_TOKEN — это токен OAuth, используемый для аутентификации запроса. Подробнее о создании токена OAuth см. в разделе « Получение токенов» .

Успешный ответ будет выглядеть примерно так:

  {
    "enabled": true,
    "gatewayId": "my-gateway-id"
  }

"enabled": true подтверждает, что интеграция коннектора API-концентратора активирована для организации.

"gatewayId" отображает имя ресурса экземпляра, к которому подключена данная организация Apigee Edge.

Проверка консолидированного статуса

Для получения консолидированного статуса , включающего подробную информацию о ходе загрузки, отправьте запрос GET к API управления Edge:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/status
  -H "Authorization: Bearer OAUTH_TOKEN

Где:

• ORG_NAME — название вашей организации Apigee Edge.

Успешный консолидированный ответ будет выглядеть примерно так, как показано ниже, показывая ход загрузки для прокси-серверов и сред. В примере ниже показана фаза Queued :

{
  "phase": "Preparing",
  "lastUpdated": "2025-09-15T02:23:50.706Z",
  "components": {
    "proxy": {
      "lastUpdated": "2025-09-15T02:23:50.706Z",
      "progress": {
        "totalItems": 10,
        "pendingItems": 1,
        "completedItems": 9,
        "failedItems": 0
      }
    },
    "environment": {
      "lastUpdated": "2025-09-15T02:23:50.706Z",
      "progress": {
        "totalItems": 5,
        "pendingItems": 0,
        "completedItems": 4,
        "failedItems": 1
      }
    }
  }
}

Объединенные поля статуса

Проверка подробного статуса загрузки

Вы можете проверить подробный статус отдельного прокси-сервера API или среды или группы элементов, отфильтрованных по состоянию, используя конечную точку /details и параметры запроса.

Статус конкретного элемента

Чтобы проверить подробный статус конкретного элемента, используйте параметры запроса filter и name . Для API-прокси с именем myproxy в организации acme вызовите API статуса следующим образом:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/acme/uapim/status/details?filter=proxy&name=myproxy \
  -H "Authorization: Bearer OAUTH_TOKEN"

Для среды с именем myenv в организации acme вызовите API статуса следующим образом:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=environment&name=myenv

Вызов вышеуказанного API приведет к получению JSON-вывода, аналогичного следующему, для недавно загруженного прокси-сервера:

{
  "name": "myProxy",
  "status": "Pending Upload",
  "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
}

Подробный статус с информацией о пересмотре

Информацию об отдельной версии прокси-сервера можно получить, указав дополнительный параметр запроса showRevisions=true . В результате будут получены сведения о каждой версии, загруженной для данного прокси-сервера.

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=proxy&name=myproxy&showRevisions=true

Вызов вышеуказанного API с параметром showrevisions приведет к выводу JSON, аналогичному следующему:

{
  "name": "myProxy",
  "status": "Pending Upload",
  "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
  "revisions": [
    {
      "name": "1",
      "status": "Up to date",
      "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
    },  
    {
      "name": "2",
      "status": "Pending upload",
      "lastSuccessfulUploadTime": "2025-09-15T02:23:55.000Z",
    }  
  ]
}

Статус загрузки группы

Вы можете получить статусы загрузки для группы элементов, используя групповые фильтры с параметром запроса state .

Чтобы узнать статус всех прокси-серверов API, находящихся в неисправном состоянии в организации acme , вызовите API статуса следующим образом:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=proxy&state=failed

Аналогично, для получения подробного списка всех сред, ожидающих загрузки в организации acme , вызовите API статуса следующим образом:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=environment&state=pending

Результатом вызова этого API будет JSON-коллекция отдельных элементов статуса, соответствующих фильтру. Пример:

[
  {
    "name": "myProxy",
    "status": "last upload failed",
    "lastSuccessfulUploadTime": "2025-09-12T02:23:50.706Z",
    "lastFailedUploadTime": "2025-09-13T02:23:50.706Z",
    "lastUploadError": "Errors connecting to API Hub"
  },
  {
    "name": "secondProxy",
    "status": "last upload failed",
    "lastSuccessfulUploadTime": "2025-09-12T02:23:51.706Z",
    "lastFailedUploadTime": "2025-09-13T02:23:51.706Z",
    "lastUploadError": "Errors connecting to API Hub"
  }
]

Параметры запроса для подробного статуса

API предоставляет три параметра запроса. Значения чувствительны к регистру.

Комбинации параметров для подробного статуса

В таблице ниже описаны возможные комбинации параметров, которые можно передать в REST API для получения подробной информации о состоянии. NA означает, что параметр будет проигнорирован. NULL означает, что параметр не указан.